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PREFACE 



This manual describes how to use the iAPX 86,88 Family utilities: 

• LINK86 

• CREF86 

• LIB86 

• LOC86 

• OH86 



These products run on 8086- and 8088-based systems. They are used by program- 
mers developing programs with ASM86, ASM89, PL/M-86, PASCAL-86, 
FORTRAN-86, or any other language translator that produces object code compat- 
ible with the iAPX 86,88 Family of processors. The iAPX 86,88 Family of pro- 
cessors inlcudes 8086, 8088, 8087, and 8089 processor chips. Because the 8086 is the 
first member of this family, this manual uses 8086 generically to represent the entire 
family. 



This manual presumes familiarity with the conventions of the operating system 
under which the iAPX 86,88 utilities are being executed. It also presumes familiarity 
with the basic requirements of individual languages and translators. 



This manual is divided into the following chapters: 

• Chapter 1, Introduction: a summary of the relationship among the utilities and 
basic concepts governing their use 

• Chapter 2, LINK86: how to invoke, use the controls for, and read the printed 
listing from LINK86 

• Chapter 3, CREF86: how to invoke, use the controls for, and read the output 
listing from CREF86 

• Chapter 4, LIB86: how to invoke and use the commands for LIB86 

• Chapter 5, LOC86: how to invoke, use the controls for, and read the printed 
listing from LOC86 

• Chapter 6, OH86 : how to invoke OH86 

This manual also contains several appendixes, meant for quick access to the follow- 
ing information: 

• iAPX 86 , 88 absolute ob j ect file format definitions (Appendix A) 

• Hexadecimal-decimal conversion information (Appendix B) 

• The effect of available memory on the performance of LINK86, CREF86, 
LIB86, and LOC86 (Appendix C) 

• Summaries of iAPX 86,88 Family utility controls and error messages: 

• LINK86 (Appendix D) 

• CREF86 (Appendix E) 

• LIB86 (Appendix F) 

• LOC86 (Appendix G) 

• OH86 (Appendix H) 



Additional information for Series III users (Appendix I). This appendix 
addresses issues specific to the Intellec Series III Microcomputer Development 
System, such as operating system dependencies and related publications. 



NOTE 

Appendix I contains pages with Series Ill-specific sample invoca- 
tions for all the iAPX 86,88 Family utilities controls and 
commands. These pages are foldout pages, designed to be opened 
out to your right and used in conjunction with general instructions 
provided in the chapters and other appendixes. 



Once you have gained sufficient familiarity with the basic principles of iAPX 86,88 
Family utilities operation, you will find the following publication convenient for 
quick syntax reference: 

• iAPX 86,88 Family Utilities Pocket Reference, order number 1 21 669. 



Before reading this manual, ensure that you are familiar with the following terms 
and conventions. 



Notational Conventions 



punctuation 
O 

[] 



UPPERCASE 

italic 

pathname 
directory-name 



other than the following must be entered if required by the 
control syntax. 

indicates that one and only one of the syntactic items 
contained within the braces is required. 

indicates that the syntactic item or items contained within the 
brackets are optional. 

indicates that the preceding syntactic item may be repeated an 
indefinite number of times (the ellipsis is often used within 
brackets and with a comma "[,...]" to indicate that preceding 
item may be repeated, but each repetition must be separated 
by a comma) 

vertical bar separates various options within the brackets [ ] 
or braces { > . 

indicates that these characters must be entered exactly as 
shown. 

indicates a meta symbol which may be replaced with an item 
that fulfills the rules for that symbol. The actual symbol may 
be any of the following: 

is a valid designation for a file; in its entirety, it consists of a 
directory-name and a filename . 

is that portion of a pathname which acts as a file locator by 
identifying the device and/or directory containing the 
filename. 



VI 



filename 

minimum-size 

maximum-size 

paragraph 

offset 

address 



is a valid name for the part of a pathname which names a file. 

are numbers and must follow Intel standards for number 
representation (see PL/M-86 or ASM86). Use the H suffix for 
hexadecimal, B suffix for binary, O or Q suffix for octal and 
D or nothing for decimal. 



segment name 
module name 
class name 
group name 
overlay name 
public symbol 
variable name 



are defined by the 8086 object file formats described in 
Appendix A. They may be up to forty characters 
long and may contain any of the following characters in any 
order: 

A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, 

W, X, Y, Z, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, ?, @, :, ., _, 



black background is used in examples to indicate the user's 
entries. 



system-id 



pathnamel, 
pathname2, 

Vx.y 



is a generic label placed on sample listings where an operating 
system-dependent name would actually be printed. 

are generic labels placed on sample listings where one or more 
user-specified pathnames would actually be printed. 

is a generic label placed on sample listings where the version 
number of the product that produced the listing would 
actually be printed. 
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CHAPTER 1 
INTRODUCTION 



Program Development 



Program development is a process of varying complexity. The complexity depends 
on the language used to develop code, the complexity of the end product, and the 
tools chosen. 

Figure 1-1 shows the development process and the tools available for development 
of an iAPX86,88 Family-based product. 

The tools described in this manual are: 

• LINK86, which is a linkage and binding tool 

• CREF86, which provides a cross-reference of information on symbols in several 
modules 

• LIB86, which is the librarian function for 8086 object modules 

• LOC86, which is the relocation tool 

• OH86, which converts 8086 absolute object information to the hexadecimal 
format 



WITH BIND 



SOURCE 
FILES 



►JTRANSLATORJ- 
■ I 

L J 



OBJECT 

MODULES 

".OBJ" 



LTL 
OBJECT 
MODULE 



r ■ — ■■ 

■ DEBUGGER * 

"J Qfl ■ 

J MONITOR ! 
I.-------J 



LINK86 



LINKED 
OBJECT 
MODULE 
".LNK" 



LIBRARY 
FILE 



-*-! CREF86 



L. .---.. J 



CROSS- 
REFERENCE 
LISTING 



-^! 



LIB86 



LOC86 



ABSOLUTE 
OBJECT 
MODULE 



"operating; 

. SYSTEM , 
"l LOADER i 
L J 



J IN-CIRCUIT I 
! EMULATOR ' 



►; oh86 j 
• i 

L___- J 



ABSOLUTE 
HEX FILE 
".HEX" 



HEX 
LOADER 



Figure 1-1 . The iAPX86,88 Family Development Process 
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Overview of the Utilities 

ASM86, ASM89, PL/M-86, PASCAL-86, FORTRAN-86, and other translators as 
well as LINK86 and LOC86 produce 8086 object modules. The language translators 
produce 8086 relocatable object modules that must usually be processed by utilities 
before execution. (Under certain circumstances the translators can produce absolute 
object modules, but this is rare and does not contribute to modular design.) LINK86 
combines 8086 object modules, and LOC86 converts relocatable object modules into 
absolute object modules. OH86 converts 8086 absolute object modules to 8086 hexa- 
decimal format. 

LINK86 combines a list of 8086 object modules into a single object module and 
attempts to match all external symbol declarations with their public symbol defini- 
tions in library modules. (LIB86 is the utility used to create and maintain program 
libraries.) The output of LINK86 is a relocatable object module. However, when 
specified in the controls, LINK86 produces a load-time-locatable (LTL) object 
module; an LTL module can be executed on an 8086-based system. (See the descrip- 
tion of LTL modules later in this chapter.) Whether the LINK86 output is an LTL or 
a relocatable object module, it can serve as input to LOC86. 

CREF86 provides a means for producing a cross-reference listing of public and 
external symbols in multiple 8086 object modules. The object modules may include 
library modules. The output produced by CREF86 should help the programmer to 
identify how symbols will be resolved by LINK86, given the same input files. 

LOC86 converts relocatable (or LTL) object modules to absolute object modules. 
Absolute object modules contain references that require the module segments to be 
placed at particular places in 8086 memory. 

The sequence in which the segments in the input modules are combined and absolute 
addresses assigned to segments is determined by the controls supplied and the order 
in which the modules are listed in the LINK86 and LOC86 invocations. 



External References and Public Symbols 

An address field that refers to a location in a different object module is called an 
external reference. An external reference differs from a relative address because the 
translator that generates the modules knows nothing about the location of the 
referenced symbol. You must declare these references as external when coding a pro- 
gram. This tells the translator, and subsequently the relocation and linkage (R&L) 
utilities, that the target of the reference is in a different module. 

A module that contains external references is called an unsatisfied module. To 
satisfy the module, a module with a public symbol that matches the external symbol 
must be found. Associated with a public symbol in a module is an address that 
allows other modules, with the appropriate external reference, to reference the 
module with the public symbol. You must define these symbols as public when 
coding the program. This tells the source translator and the R&L utilities that other 
modules can reference the symbol. 

If there are external references that are not satisfied by public symbols, warning 
messages are issued and the resulting module remains unsatisfied. 
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Use of Libraries 

Libraries aid in the job of building programs. The library manager program, LIB86, 
creates and maintains files containing object modules. 

LINK86 and CREF86 treat library files in a special manner. If you specify a library 
file in the input to these utilities, they search the library for modules that satisfy 
unresolved external references in the input modules already read. This means that 
libraries should be specified after the input modules that contain external references. 
If a module included from the library has an external reference, the library is 
searched again to try to satisfy the reference. This process continues until all external 
references have been the subject of a search of all public symbols in the library 
modules. 



When LINK86 and CREF86 search a library, they normally include only library 
modules that satisfy external references in the output. If no external references are 
satisfied by a library, no modules from the library are included in the LINK86 out- 
put module or the CREF86 output listing. However, LINK86 and CREF86 provide 
the means to unconditionally include a library module even if there is no external 
reference to it. Figure 1-2 shows LINK86 handling of a library file. 
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Figure 1-2. Library Linkage by LINK86 
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Relative Addressing 

The relative addresses of instructions and data in program modules are assigned by 
the source translator. The addresses are relative to the beginning of the segment in 
which they reside. The relative address is actually the number of bytes from the 
beginning of the segment. 

After LINK86 combines all the input segments, LOC86 can be used to assign 
absolute memory addresses to all relative addresses. The resulting output module 
can only be executed when its segments are loaded at the absolute addresses assigned 
by the command. If LINK86 is used to create a bound object module, LOC86 is not 
needed to execute the program. 

The LINK86/LOC86 Process 

Although controls are not required for LINK86 and LOC86 execution, the com- 
mands invoking them may contain controls that affect their output. The controls 
make it possible to change the defaults for module combination, address assign- 
ment, and output information. 

The inputs are object modules in disk files. The input modules can contain relative 
addresses, absolute addresses, external references, and public symbols. The input 
modules must be in the 8086 object module format such as is generated by 8086 
translators and LINK86 and LOC86 themselves. 

LINK86 combines segments from the input modules, and for LTL object modules 
LINK86 orders segments in groups and assigns offsets. LOC86 orders the segments 
and assigns absolute addresses according to the controls specified with the command 
and/or the default algorithms. Both commands output the module when processing 
is completed along with any error messages and diagnostic information. Figure 1-3 
shows the LINK86/LOC86 process. 
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Figure 1-3. The LINK86/LOC86 Process 
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An 8086 Overview 

To use the R&L commands you must have an understanding of the following 
concepts: 

• Addresses, given as offsets into segments, which must be translated into 
absolute memory addresses, or base offsets 

• Segment definitions, which identify contiguous pieces of information, usually 
code or data 

• Class definitions, which identify segments that share common attributes and 
should be kept together 

• Group definitions, which identify segments that must be kept within a 64K byte 
range of memory 

• Overlay definitions, which identify modules that will be loaded in memory at 
different times during execution. 

• Load-time-locatable object modules 



Memory 

The 8086 can address up to a maximum of a megabyte of memory. In decimal a 
megabyte is 1,048,576 bytes. Memory addresses are always shown in hexadecimal. A 
megabyte of memory has the addresses: OH through OFFFFFH. 

Not all 8086-based systems will have a full megabyte of memory. Many systems will 
have gaps in the memory that is available. The different portions of memory will 
probably be implemented with different types of memory chips. The system monitor 
or supervisor is usually stored in ROM or PROM chips. Because it is not modified 
by execution it can be a permanent part of the system. This prevents the need to load 
it each time the system is turned on. The data that is referenced often is kept in high- 
speed RAM because it is modified frequently. It may be practical to keep data that is 
referenced less often in slower-speed memory. The size and composition of a 
system's memory is totally dependent on the application the system serves. 

Linkage and relocation is designed to handle the linking and locating of your pro- 
gram, no matter how your 8086-based system memory is implemented. It provides 
very flexible segment placement within any given memory configuration. 



8086 Addressing Techniques 

The 8086 addresses memory with a 20-bit address that is constructed from a segment 
address and a 16-bit offset from that segment address. This means that with a single 
segment address, 64K bytes of memory is directly addressable by changing only the 
offset. 

A hardware segment address is a 20-bit address. But the segment address is con- 
strained such that the segment is placed on a boundary that is a multiple of 16 (10H). 
The segment address can be set to any hexadecimal address ending in 0: 

OH 
010H 
020H 



0FFFF0H 
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Because the low four bits of the 20-bit segment address are always zero, the segment 
address can be represented with only 16 bits. 

The segment address is kept in one of four 16-bit segment registers. Because there 
are four segment registers, the 8086 can, at any moment, access 256K (4 x 64K) bytes 
of memory. The full megabyte of memory is accessed by changing the values in the 
segment registers. Figure 1-4 shows the 8086 addressing concept. 
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Figure 1-4. 8086 Addressing 
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Segments 

Programs comprise pieces called segments, which are the fundamental units of 
linkage and relocation. The basic divisions have functional purposes related to the 
hardware configuration of memory. The portions of programs that are to be kept in 
ROM or PROM can be put in separate segments from the portions that will be kept 
in RAM. 

The 8086 Assembler allows the programmer to name the segments of the program 
being developed. The PL/M-86 compiler may generate predefined names for 
segments. 

A segment is a contiguous area of memory that is defined at translation time 
(assemble or compile). When defined, a segment does not necessarily have a fixed 
address or size. A fixed address is assigned to a segment during the locate function. 
The size can be changed by combining segments and by a control that specifies a 
specific size. Some translations may produce absolute object information, with 
absolute addresses and a specific segment size. 
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LINK86 combines all segments with the same complete (segment, class and overlay) 
name and combination type (memory, stack, etc.) from all input modules. The 
ordering of segments is done on the basis of these combined segments. The manner 
in which segments are combined depends on the alignment of the segments (which is 
described in the next topic) and a combining attribute associated with the segment. 

When we refer to combining segments, we are talking about how the segments will 
be loaded in memory, not how they will be stored in the output module. The 
segments in the LOC86 output module contain addresses that determine where they 
will be loaded in memory. The segments reside in the output module in the same 
order as they were in the input modules. Figure 1-5 shows the physical relationships 
between the input modules, output module, and loaded program. 
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Figure 1-5. Segment Physical Relationships 
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Segment Alignment 

A segment can have one (and in the case of the inpage attribute, two) of five align- 
ment attributes: 

• Byte, which means a segment can be located at any address 

• Word, which means a segment can be located only at an address that is a 
multiple of two, starting from address OH 

• Paragraph, which means a segment can be located only at an address that is a 
multiple of 16, starting from address 

• Page, which means a segment can be located only at an address that is a multiple 
of 256, starting from address 

• Inpage, which means a segment can be located at whichever of the preceding 
attributes apply, plus must be located so that it does not cross a page boundary 

Figure 1-6 shows the segment alignment boundaries. 

Any alignment attribute except byte can result in a gap between combined segments. 
For example, when two page-aligned segments are combined, there will always be a 
gap, unless the first happens to be an exact multiple of 256 bytes in length. 
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Figure 1-6. Segment Alignment Boundaries 
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Segment Combining 

Segments containing data and code are combined end to end. There may be a gap 
between the segments if the alignment characteristics require it. The relative 
addresses in the segments are adjusted for the new longer segment. 

There are two special cases of segment combination: stack segments and memory 
segments. Such translators as PL/M-86 define these segments with the names 
STACK and MEMORY. With ASM86 you must define them by adding the STACK 
or MEMORY parameter to the SEGMENT directive. 

When stack segments are combined, they are overlaid but their lengths are added 
together. 

When memory segments are combined, they are overlaid with their low addresses at 
a common address. The length of the combined memory segment is the length of the 
largest segment that was combined. No relative address adjusting is necessary. Nor- 
mally the memory segment is located above (at a higher memory address) the rest of 
the program segments if no controls are used to override this. 

To make sure that stack segments are combined correctly, you should always give 
them the same segment name in each module. The same is true of memory segments. 
If you are going to link assembly language routines to PL/M-86 routines you should 
give them the names STACK and MEMORY to be compatible with PL/M-86. 



Segment Locating 

Segments are located in the order in which they are encountered in the input 
modules. If classes (described in the next section) are defined, the segments from a 
class are located together. The locating algorithm can be changed by using LOC86 
locating controls. 
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One variation to the sequential locating of segments is how the MEMORY segment 
is located. When the first segment with the memory attribute is encountered, it is 
placed last in the list of segments. This means that after all other segments are 
located, the MEMORY segment will be assigned the highest address in the output 
module. 

NOTE 

The MEMORY segment may not get located at the top of the module if its 
name or class name appears in any LOC86 control (other than SEGSIZE) or 
it has the absolute attribute. 



Classes 

A class is a collection of segments. When segments are defined in assembly 
language, a class name can be specified. The segments generated by such translators 
as PL/M-86 are generated with predefined class names. Any number of segments 
can be given the same class name. Class names can extend beyond module bound- 
aries; the same class name can be used in different modules that are to be combined. 

The primary purpose of classes is to collect together (in an arbitrary order) segments 
that share a common attribute and to manipulate this collection at locate-time by 
specifying only the class name. 

All segments with the same class name are located together in the memory address 
space of the output module. (You can override class collection by specifying the 
location of segments with the LOC86 ORDER control or LOC86 ADDRESSES 
control.) 

Classes give you a second means of collecting like segments in the output module. 
The first is giving segments the same name. If you are developing several modules 
that are to be combined, you may want to give the segment containing executable 
code the name CODE in each module. If there are several differently named 
segments within a module that contain executable code, you may want to give these 
segments the class name of CODE that causes them to be located together but not 
combined. (The same name can be used for segments and classes.) 



Groups 

A group is also a collection of segments. Groups define addressing range limitations 
in 8086 object modules. A group specifies a collection of segments that must be 
located within a 64K byte range. This means that the entire group of segments can be 
addressed with offsets from a single segment register. Or, to put it another way, the 
segment register need not be changed when addressing any segment in a group. This 
permits efficient addressing within the module. 

Group addressing always begins at an address that is a multiple of 16 (i.e., a 
paragraph boundary). R&L does not manipulate segments of a group to make sure 
they fall within a 64K byte range. However, if they do not fit in the range, a warning 
message is issued. 

The segments included in a group do not have to be contiguous in the output 
module. The only requirement is that all the segments defined in the group must 
totally fall within 64K bytes of the beginning address of the group. 
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Overlays 

Sometimes your 8086 program is too large to fit into the memory available on the 
system. Overlays permit programs to be larger than the available memory. 

Typically, an overlay is composed of code and data that is executed in one phase of a 
program's execution, but not used at any other time. Once executed the memory 
used by this code can be overwritten with code and data used in an other phase. 
Sections of code that occupy the same part of memory at different times during 
execution are called overlays. 

Part of an overlaid program is always resident in memory; it usually comprises the 
main program module, frequently used routines, and the overlay loader. This part 
of the program is called the root. Figure 1-7 illustrates the memory configuration of 
one program that uses overlays. 



t space mm 

/ 


|§§. ' oy I r lay 4 ' piiilijr 


7 / 

/ RESERVED /mm 

L ' 


OVERLAY 3 / 


7 '' r 

/ for root mm 

i_ mm 


Kg:. OVERLAY 2 / 


7 / 

/ module mmi 

/ mm 


OVERLAY 1 / 




/ ROOT / 

/ MODULE / 


7 
/ 

OVERLAY SPACE / 

/ 



Figure 1-7. Memory Configuration of Program with Overlays 639-7 



Position-Independent Code and Load-Time- 
Locatable Code 

An LTL (load-time-locatable) program can be loaded anywhere in memory (assum- 
ing alignment attributes are honored). Code and data addresses are assigned by the 
system loader. References to segment bases (segment registers) are permitted. The 
loader, when it determines where to locate each segment, must resolve these 
references to the segment bases. Before executing the LTL program, the loader must 
also initialize the segment registers. 

A PIC (position-independent-code) program is an LTL program, but it contains no 
references to segment bases. To execute these programs the loader need only place 
the program in memory (recognizing alignment attributes) and initialize the segment 
registers and go. No fixup of segment bases is required. 
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CHAPTER 2 
LINK86 



LINK86 combines 8086 object modules and resolves references between 
independently translated modules. LINK86 takes a list of files and controls as input 
and produces two output files: a print file and an object file. 

Figure 2-1 illustrates the linkage process. The input files may be any object module 
(output from a translator, LINK86, LOC86 or an 8086 library file). The print file 
contains diagnostic information. The output object file is a bound load-time- 
locatable module or simply a relocatable module. 

This chapter provides details concerning the LINK86 invocation, controls, and print 
file. For definition of file-naming and syntax notation conventions used in this 
chapter, refer to Notational Conventions following the Preface. For a summary of 
the LINK86 controls and information on error and warning messages that may be 
produced, refer to Appendix D. For details concerning symbol table space limita- 
tions, refer to Appendix C. 
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LINK86 Invocation Line 

The general syntax for the invocation line is: 

[directory-name] L I N K 8 6 input list[l output file] [controls] 

The input list is one or more modules to be linked together into a single object 
module: 

pathname[ (.module name[ , ...])][,.. .] 

Unless a module name is specified, all modules in a pathname are included. If the 
pathname is a library file, any modules named in parentheses are included in the out- 
put file even if they do not contain public symbol definitions for external symbols 
declared elsewhere in the input list. 
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The input list may also contain the control PUBLICSONLY before selected 
pathnames. If you wish to include a file called PO or PUBLICSONLY, ensure that 
the filename is preceded by a directory-name in order to distinguish it from the con- 
trol or its abbreviation. 

The order of modules in the input list affects the order of segments in the output file. 

TO output file designates the file to receive the linked object module. If output file is 
not specified, then output is directed to a file that has the same pathname as the first 
element in the input list, but its extension is .LNK. If the first element in the list is a 
PUBLICSONLY control, then the first pathname in its argument is used for the 
default name. 

If the BIND control is specified, then the default name for the output file has no 
extension, and the object module can be executed without locating. 

The controls can be any subset of the controls specified in the next section. 

LINK86 Controls 

The controls are described in table 2-1. 

Table 2-1 . Summary of LINK86 Controls 



Control 


Abbrev. 


Default 


ASSIGN(Oar/a&/e(acldress)}[,...]) 


AS 


Not applicable 


ASSUMEROOT(patf»A7ame) 


AR 


Not applicable 


BIND 


Bl 


NOBIND 


NOBIND 


NOBI 


COMMENTS 


CM 


COMMENTS 


NOCOMMENTS 


NOCM 


FASTLOAD 


FL 


NOFASTLOAD 


NOFASTLOAD 


NOFL 


INITCODE 


IC 


Not applicable 


LINES 


LI 


LINES 


NOLINES 


NOLI 


MAP 


MA 


MAP 


NOMAP 


NOMA 


MEMPOOL(m/n-s/ze[,/77ax-s/ze]) 


MP 


Not applicable 


UAME(module name) 


NA 


Not applicable 


OBJECTCONTROLS( 

{LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS [EXCEPT(symbol [,...])] | 
NOPUBLICS [EXCEPT(s/m6o/ [,...]>] | 
TYPE | NOTYPE | 
PURGE | NOPURGE>[,...]) 


OC 


Not applicable 


ORDER( <.group(isegment[\class[\overlay]]} 
[,...1)> 


OD 


Not applicable' 



2-2 



iAPX 86,88 Family Utilities 



LINK86 



Table 2-1 . Summary of LINK86 Controls (Cont'd.) 



Control 


Abbrev. 


Default 


OVERLAY[(oi*?r/ay)] 


OV 


NOOVERLAY 


NOOVERLAY 


NOOV 


PRINT[(paf/?name)] 


PR 


PRINT(otyecftf/e.MP1) 


NOPRINT 


NOPR 


PRINTCONTROLS( 

i LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS[EXCEPT(sym6o/[,...])] | 
NOPUBLICS [EXCEPT(sy/77/Jo/ [,...])] I 
TYPE | NOTYPE | 
PURGE |NOPURGE}[,...]) 


PC 


Not applicable 


PUBLICS [EXCEPT(symbo/ [,...])] 


PL [EC] 


PUBLICS 


NOPUBLICS [EXCEPT(symdo/[,...])] 


NOPL[EC] 


PUBLICSONLY(patf)/7ame[,...]) 


PO 


Not applicable 


PURGE 


PU 


NOPURGE 


NOPURGE 


NOPU 


REN AMEGROUPS(tflrroup TO group >[,...]) 


RG 


Not applicable 


SEGSIZE{ isegment [ \class [ \ overlay]] 
( min-size[, [max-size]]) >[,...]) 


SS 


Not applicable 


SYMBOLS 


SB 


SYMBOLS 


NOSYMBOLS 


NOSB 


SYMBOLCOLUMNS({:i | 2| 3| 4}) 


SC 


SYMBOLCOLUMNS(2) 


TYPE 


TY 


TYPE 


NOTYPE 


NOTY 



If you specify a control more than once in a single invocation line, only the last ver- 
sion entered counts. For example, if you enter NOMAP on the invocation line and 
then later decide you want a link map, you can specify MAP. The ASSIGN control, 
however, is an exception to this general rule. 

The following controls are effective only when the BIND control is specified: 

FASTLOAD 

MEMPOOL 

ORDER 

PRINTCONTROLS 

SEGSIZE 

SYMBOLCOLUMNS 

The following control is effective only when the BIND control is NOT specified: 
INITCODE 

The following control is effective only when the OVERLAY control is specified: 
ASSUMEROOT 

At the end of this document you will find operating system-specific examples of the 
LINK86 controls. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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Syntax 

A S S I G N ( { variable-name ( address )}[,...]) 

Abbreviation 

AS 

Default 

Not applicable 

Definition 

ASSIGN makes it possible to define absolute addresses for symbols at LINK time. 
The absolute address associated with the variable-name is specified in address, 
which should be an absolute 20-bit memory address that conforms to PL/M-86 
notation. The variable-name is internally defined as a PUBLIC symbol. 

Notes 

• This control is particularly useful for memory-mapped I/O. 

• If the variable-name has a matching public definition in another module, the 
public definition in that module is flagged as as duplicate. Whenever a reference 
to the variable-name occurs, the variable defined in the ASSIGN control 
governs. 

• If multiple ASSIGN specifications are provided in one LINK86 invocation, all 
will be effective (not only the final entry). 
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Syntax 

ASSUMEROOT (pathname) 

Abbreviation 

AR 

Default 

Not applicable 

Definition 

ASSUMEROOT suppresses the inclusion of any library module(s) in an overlay if 
the library module(s) have already been included in a root file identified by 
pathname. When this control is used, the root file is scanned, and all external, 
undefined symbols in the overlay modules which have a matching definition in the 
root file are marked "temporarily resolved." This marking means that while a 
library search for the symbols will not be made, their status remains externally 
undefined until the overlays are linked with the root. 

Notes 

• This control should be used only in conjunction with the OVERLAY control 
and libraries. 

• This control will not eliminate common library modules from overlay to 
overlay. 

• This control may not be used when an input module already has an overlay 
record. 
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Syntax 

BIND 
NOBIND 



Abbreviation 

BI 
NOBI 



Default 

NOBIND 

Definition 
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BIND combines the input modules into a load-time-locatable (LTL) module. An 
LTL module may be loaded and executed, and any logical reference to a segment or 
group base can be resolved at load time. The load-time-locatable output cannot be 
loaded by the ICE-86 loader or UPM. 



Notes 



FASTLOAD, MEMPOOL, ORDER, SEGSIZE, and SYMBOLCOLUMNS 

have no effect when NOBIND is specified. 

When NOBIND is in effect, [NO]LINES, [NOJSYMBOLS, [NO]PUBLICS, 
and [NO]PURGE affect only the output object module. 

When BIND is specified, the default object file name has no extension. 
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Syntax 

COMMENTS 
NOCOMMENTS 

Abbreviation 

CM 
NOCM 

Default 

COMMENTS 

Definition 

COMMENTS allows object file comment records to remain in the output module. 
The NOCOMMENTS control removes all comment records except those designated 
as nonpurgable. 

Comment records are added to the object module for various reasons. All 
translators add a comment record, identifying the compiler or assembler that pro- 
duced it. 

Comment records are superfluous to the production of executable code and may be 
removed at any time during the development process. 

Notes 

• See PURGE, PRINTCONTROLS and OBJECTCONTROLS. 

• COMMENT records should not be removed when you submit an object file in a 
Software Problem Report. 

• NOCOMMENTS will decrease the size of the output object file. 



2-7 



FASTLOAD/NOFASTLOAD 



iAPX 86,88 Family Utilities 



Syntax 

FASTLOAD 
NOFASTLOAD 



Abbreviation 

FL 
NOFL 



Default 

NOFASTLOAD 

Definition 

FASTLOAD reduces program loading time by causing data record concatenation. 
The data records are concatenated to a maximum length of 64K. FASTLOAD also 
makes the object file compact by removing such information as local symbols, 
public records, comments, and type information (unless the object file contains 
unresolved external symbols). 

Notes 

• This control is effective only when BIND is specified. 

• Output produced with this control in effect may be incompatible with LINK86 
versions earlier than 2.0. 
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Syntax 

IHITCODE 

Abbreviation 

IC 

Default 

Not applicable 

Definition 



INITCODE 



INITCODE causes LINK86 to create a new segment that contains code to initialize 
the segment registers. The equivalent assembly language code is shown below: 

STACKFRAME DW stackframe 



DATAFRAME 


DU 


data frame 


EXTRAFRAME 


DW 
CLI 


extra frame 




MOV 


SS, CS:STACKFRAME 




MOV 


SP # stack offset 




MOV 


DS, CSrDATAFRAME 



MOV ES, CSrEXTRAFRAME 
J M P program start 



Notes 



The initialization code segment is created only if a register intialization record 
for 8086 segment registers exists in the input. These register initialization 
records are automatically produced by 8086-based translators for main 
modules. 

BIND and OVERLAY controls used in conjunction with INITCODE will cause 
LINK86 to ignore the INITCODE control and issue a warning message. 

INITCODE should be used to ensure compatibility with 8085-based LINK86, 
LOC86, and LIB86 products. 

The name of the new segment, if created, is ??INITCODE. 
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Syntax 

LINES 
NOLINES 



Abbreviation 

LI 
NOLI 



Default 

LINES 

Definition 
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LINES allows line number information to remain in the object file. ICE-86 and 
other debuggers use this information. The line number information is not needed to 
produce executable code. The NOLINES control removes this information from the 
output file. 



Notes 

See PRINTCONTROLS and OBJECTCONTROLS. 

See the PURGE control. 

NOLINES will decrease the size of the output object file. 

Unless BIND is in effect, LINES/NOLINES affects only the object module. 

LINES has no effect on local symbols; the inclusion of local symbol records in 
the object file is controlled by SYMBOLS. 
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Syntax 

MAP 
NOMAP 



MAP/NOMAP 



Abbreviation 

MA 
NOMA 



Default 

MAP 

Definition 

MAP produces a link map and inserts it in the PRINT file. The link map contains 
information about the attributes of logical segments in the output module. This 
includes size, class, alignment attribute, address (if the segment is absolute) and 
overlay name (if the segment is a member of an overlay). 

NOMAP inhibits the production of the link map. 

Notes 

• MAP can be overridden by the NOPRINT control. 

• See the discussion of the link map at the end of this chapter. 
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Syntax 

M E M P L (minimum-size[ , maximum-size] ) 

Abbreviation 
MP 

Default 

Not applicable. 

Definition 

MEMPOOL specifies the dynamic memory requirements of the program. This 
allows the loader to check free memory at load time, and prevent a run-time error. 

The minimum size is a 20-bit number. There are three ways of specifying this value: 

• + indicates that the number should be added to the current dynamic memory 
requirements. 

• — indicates that the number should be subtracted from the current dynamic 
memory requirements. 

• no sign indicates that the number should become the new minimum dynamic 
memory requirement. 

The maximumsize is a 20-bit number. There are two ways of specifying this value: 

• + indicates that the number should be added to the current minimum dynamic 
memory requirement. 

• no sign indicates that the number should become the new maximum dynamic 
memory requirement. 

Notes 

• The minimum-size must be less than or equal to the maximum-size. 

• MEMPOOL has no effect unless the BIND control is also specified. 
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Syntax 

N A M E ( module name ) 

Abbreviation 

NA 

Default 

The module name of the first element in the input list. 

Definition 

NAME assigns the specified module name to the output module. If NAME is not 
specified, then the output module will have the name of the first module in the input 
list. 

The module name may be up to 40 characters long. It may be composed of any of 
the following characters in any order: 

? (question mark), 
@ (commercial at), 
: (colon), 
. (period), 

(underscore), 

A, B, C, ...,Zor 
0,1,2,..., 9. 

Lower-case letters may be used, but they are automatically converted to uppercase. 

Notes 

• NAME does not affect the output file's name. Only the module name in the 
output module's header record is changed. 
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OBJECTCONTROLSCUINES | NOLINES | 

COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS [EXCEPT (symbol[, ...])] \ 
NOPUBLICS [EXCEPT (symbol[, ...]) 
TYPE | NOTYPE | 
PURGE | NOPURGE} [,...] 
) 



Abbreviation 

OC 

Default 

Controls apply to both the print file and the object file. 



Definition 

OBJECTCONTROLS causes the controls specified in its arguments to be applied to 
the object file only. Comment records, line number records, local and public symbol 
records, and symbol type records are selectively included or excluded from the 
object file. This will not affect the print file nor the information contained in it. 



Notes 

• Abbreviations for the controls within the parentheses may be given. 

• A control specified in both OBJECTCONTROLS and PRINTCONTROLS has 
the same effect as specifying it once outside of these controls. 
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Syntax 

R D E R ( {group name ( {segment name 

[ \ class name[\overlay name]] } 

Abbreviation 

OD 

Default 

Segments are placed into object file in the same order in which they were 
encountered in the input list. 

Definition 

ORDER specifies a partial or complete order for the segments in one or more 
groups. 

The group name identifies the group whose segments are to be ordered. 

The segment name identifies the segments to be ordered. The \ class name and 
\overlay name may be used to resolve conflicts with duplicate segment names. If 
\overlay name is specified, the \class name is required. 

Notes 

• ORDER has no effect unless BIND is also specified. 

• If one of the segments specified is not contained in the designated group, an 
error message is generated. 

• See discussion of module combination at the end of the chapter for details of the 
default ordering. 



2-15 



OVERLAY/NOOVERLAY 



iAPX 86,88 Family Utilities 



Syntax 

V E R L A Y [( overlay name ) 
NOOVERLAY 



Abbreviation 

ov 

NOOV 



Default 

NOOVERLAY 

Definition 

OVERLAY specifies that all of the input modules shall be combined into a single 
overlay module. When the optional overlay name argument is specified, all 
segments contained within the overlay module have that name in addition to their 
segment names and class names. When overlay name is not specified, LINK86 uses 
the module name of the first module in the input list. 



Notes 



Each overlay in a given program must be linked separately before they are all 
linked into a single object module. 

The overlay specified in the argument must be the same as the overlay name 
used when calling the operating system to load the overlay. 

When linking root and overlay files, LINK86 assumes the first file in the 
invocation line is the root. 

The ASSUMEROOT control can be specified in conjunction with the 
OVERLAY control. 
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Syntax 

PR I HT [(pattname)] 
NOPRINT 

Abbreviation 

PR 
NOPR 

Default 

PRINT(o6/ecff/7e.MP1) 

Definition 

PRINT allows you to direct the link map and other diagnostic information to a 
particular file. If the PRINT control is not specified or if the control is given without 
an argument, the print file will have the same pathname as the output file except the 
extension will be .MP 1 . NOPRINT prevents the creation of this file. 

Notes 

• The discussion at the end of this chapter describes the contents of the print file. 

• MAP, SYMBOLCOLUMNS, LINES, SYMBOLS, PUBLICS and 
PRINTCONTROLS affect the contents of the print file. 
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Syntax 

PRINTCONTROLSULINES | NOLINES | 

COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS [EXCEPT(sym6o/[, ...])] | 
NOPUBLICS [EXCEPT isymbol[, ...])] 
TYPE | NOTYPE | 
PURGE | NOPURGE} [,...] 
) 



Abbreviation 

PC 

Default 

Controls apply to both the print file and the object file. 

Definition 

PRINTCONTROLS causes the controls specified in its arguments to be applied to 
the print file only. Line number information, and local and public symbol informa- 
tion are selectively included or excluded from the print file. This will not affect the 
object file or the information contained in it. 



Notes 



When a control is specified in both the PRINTCONTROLS and the 
OBJECTCONTROLS, it has the same effect as specifying it once outside of 
these controls. 

Abbreviations to the parenthesized controls may be used. 

Unless BIND is specified, PRINTCONTROLS and its arguments have no 
effect. 
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Syntax 



PUBLICS/NOPUBLICS 



PUBLICS [EXCEPT (public symbol [, ...])] 
NOPUBLICS[EXCEPT <pufc//csy/nZ>o/ [,...]>] 



Abbreviation 



PL [EC] 
NOPL [EC] 



Default 

PUBLICS 

Definition 

PUBLICS causes the public symbol records to be kept in the object file and the 
corresponding information to be placed in the print file. Public symbol records are 
needed to resolve external symbol definitions in other files. The EXCEPT sub- 
control allows you to modify the control. Public records are used by LINK86 to 
resolve external references. 



Notes 



The scope of PUBLICS can be modified by PRINTCONTROLS and 
OBJECTCONTROLS. 

Unless BIND is specified PUBLICS/NOPUBLICS affect only the object file. 

NOPUBLICS will decrease the size of the output object file. 
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Syntax 

PUB LI CS0\iU (pathname [,...]) 

Abbreviation 

PO 

Default 

Not applicable 

Definition 

PUBLICSONLY is an input list control. When used it must appear in the input list 
and not the control list. 

PUBLICSONLY indicates that only the absolute public symbol records of the argu- 
ment files will be used. The other records in the module will be ignored. This can be 
used to resolve external references to 8089 files and overlays when a multifile overlay 
system is desired. 



Notes 



Although it is possible to create overlays using PUBLICSONLY, it is easier to 
use the OVERLAY control to create overlays. 
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Syntax 

PURGE 
NOPURGE 



PURGE/NOPURGE 



Abbreviation 

PU 
NOPU 



Default 

NOPURGE 

Definition 

PURGE in the control list is exactly the same as specifying NOLINES, 
NOSYMBOLS, NOCOMMENTS, NOPUBLICS, and NOTYPE. NOPURGE in 
the control list is the same as specifying LINES, SYMBOLS, COMMENTS, 
PUBLICS, and TYPE. 

PURGE removes all of the debug or public records from the object file and their 
information from the print file. It will produce the most compact object file 
possible. 

The records that would be included by NOPURGE are useful to debuggers, but 
otherwise they are unnecessary for producing executable code. 



Notes 

• PRINTCONTROLS and OBJECTCONTROLS can be used to modify the 
scope of PURGE. 

• Unless BIND is specified, PURGE affects only the output object file. 
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Syntax 

RENAMEGROUPS ({croup name TO group name} [,...]) 

Abbreviation 

RG 

Default 

All groups keep the name they already have. 

Definition 

RENAMEGROUPS allows you to change the group names assigned by the 
translator. The first group name must be an existing group in one of the modules in 
the input list. 

Notes 
None 
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Syntax 

SE6S I Z E (isegment name[\class nam e[\ overlay name]] 
(minimum size[ , [maximum size]] ) } 

Abbreviation 

SS 

Default 

Not applicable 

Definition 

SEGSIZE allows you to specify the minimum memory space needed for any seg- 
ment. If you specify the maximum size for a segment, that segment must either not 
be a member of any group or be the last segment in the group. 

The segment name identifies the segment whose size is to be changed. 

The minimum size is a 16-bit number. There are three ways of specifying this value: 

• + indicates that the number should be added to the current segment length. 

• — indicates that the number should be subtracted from the current segment 
length. 

• no sign indicates that the number should become the new segment length. 

The maximum size is a 16-bit number. There are two ways of specifying this value: 

• + indicates that the number should be added to the minimum segment length. 

• no sign indicates that the number should become the new maximum segment 
length. 

Notes 

• The maximum segment size must always be greater than or equal to the 
minimum segment size. 

• Segment lengths are initially assigned by the translator. 

• Unless BIND is also specified SEGSIZE has no effect. 
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Syntax 

SYMBOLS 
NOSYMBOLS 



Abbreviation 

SB 
NOSB 



Default 

SYMBOLS 

Definition 

SYMBOLS specifies that all local symbol records shall be included in the object file. 
Local symbol records are used by debuggers. 

Notes 

• Unless BIND is also specified, SYMBOLS affects only the output object file. 

• NOSYMBOLS will decrease the size of the output object file. 

• SYMBOLS has no effect on line numbers; the inclusion of line numbers in the 
object file is controlled by the LINES control. 
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SYMBOLCOLUMNS 



Syntax 

SYMB0LC0LUMNS({1 | 2 | 3 | 4>) 

Abbreviation 

SC 

Default 

SYMB0LC0LUMNS(2) 

Definition 

SYMBOLCOLUMNS indicates the number of columns to be used when producing 
the symbol table for the object module. Two columns fit on a 78-character line; four 
columns fit on a single 128-character line printer line. 

Notes 

• SYMBOLCOLUMNS has no effect unless BIND is also specified. 
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Syntax 

TYPE 
NOTYPE 

Abbreviation 

TY 
NOTY 

Default 
TYPE 

Definition 

TYPE specifies that type checking is to beperformed on the object file. Symbol type 
records produced by the translator are used by LINK86 to perform type checking on 
modules. Symbol type records should be kept in the file if it may be relinked with 
another file. 



Notes 



NOTYPE will decrease the size of the ouput object file without affecting 
run-time operation. 
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LINK86's Print File 

The print file is always created unless you specify NOPRINT. The optional argu- 
ment to PRINT designates the name of the print file. The default print file is the 
object file with the extension .MP1 . 

The print file may contain as many as five parts: 

1 . A header (always in the print file) 

2. A link map (requires MAP) 

3. A group map (requires BIND) 

4. A symbol table (requires BIND and PUBLICS, LINES, or SYMBOLS) 

5 . An error message list (always included when they occur) 

The Header 

The header is self-explanatory; it identifies the 8086 linker by version number and 
gives the important details about the input and output files used during this execu- 
tion. Figure 2-2 shows an example of LINK86's print file header. 



system-id 6086 LINKER, Vx.y 

INPUT FILES: : pathnamel .pathname! 

OUTPUT FILE: : pathnames 

CONTROLS SPECIFIED IK INVOCATION COMMAND: 

BIND 
DATE: UM/DD/YY TIME: HH:MU:SS 



Figure 2-2. LINK86 Print File Header 



The Link Map 

The link map supplies useful information about segments in the object file — order, 
size, alignment attribute, and segment, class, and overlay names. Figure 2-3 shows 
LINK86's link map. 



LINK MAP OF MODULE ROOT 

LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT 

09B6H t» CODE 

0016H h CONST 

0B38H ------ H DATA 

0«42H h STACK 

OOOOh b MEMOR1 

0OO0H G ??SEG 

INPUT MODULES INCLUDED: 
pathnameHROOT) 



CLASS 

CODE 

CONST 

DATA 

STACK 

MEMOftI 



Figure 2-3. LINK86 Link Map 
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The map consists of three parts: 

• Segment map 

• Input module list 

• Unresolved symbol list 

The segment map describes all of the segments included in the object file. Each seg- 
ment description includes five entries: length, the address (if the segment is 
absolute), alignment attribute, segment name, class name and overlay name, if any. 

A segment may have any one of the following alignment attributes: 



A 
B 
G 
M 


absolute 

byte 

paragraph 

member of an LTL group 


P 
U 


page 
word 


R 


in-page 



In-page alignment means that the entire segment must be resident within a single 
256-byte page. The address of the first byte in any page has zeros in the first 2- 
hexadecimal digits (00H, 100H, 200H,...OFFFOOH). 

The module list identifies the order of modules included in the output file. LINK86 
gives both the file containing the module and the module name for each entry in the 
list. 

The unresolved symbol list itemizes each external symbol whose public definition 
was not encountered. The module that references the unresolved symbol is also 
indicated. The printed message that appears under the heading UNRESOLVED 
EXTERNAL NAMES is as follows: 

• symbol name IN pathname {module name) 

• If ASSUMEROOT is specified, the message would read: 
symbolname (DEFINED IN ROOT-F I LE .pathname) 

• If PUBLICS/NOPUBLICS EXCEPT is specified, the message would read: 
symbolnamelW LINK86 COMMAND LINE 

The Group Map 

LINK86 produces a group map when the BIND control is specified. Each group 
name and all segments contained in that group are listed. The offset from the group 
base for each segment appears to the right of the segment name. Figure 2-4 shows an 
example of the group map . 



GROUP HAP 




GROUP NAME 


: CGROUP 


OFFSET 


SEGMENT NAME 


O00OH 


CODE 


GROUP NAME 


: DGROOP 


OFFSET 


SEGMENT NAME 


O00OH 


CONST 


0016H 


DATA 


OBMEH 


STACK 


0F90H 


MEMORY 



Figure 2-4. LINK86 Group Map 
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The Symbol Table 

LINK86 produces a symbol table only when the following conditions are true: 

1 . BIND is specified 

2. PRINT and MAP controls are in effect. 

3. At least one of the following controls is in effect: PUBLICS, LINES, or 
SYMBOLS. 

Figure 2-5 shows LINK86's symbol table with the SYMBOLCOLUMNS set at two 
(the default). The symbol table is shown in two parts: the top section contains the 
public symbol information; the lower section contains line and local symbol 
information. 



SYMBOL TABLE OF MODULE ROOT 



OFFSET TYPE SYMBOL 



OFFSET TYPE SYMBOL 



G(2) 


0166H 


PUB 


BIMDCONTROL 


G(2) 


0O4CH 


PUB 


BNODEBASE 


G(2) 


0018H 


PUB 


BUFBASE 


G(2) 


0016H 


PUB 


BUFLEM 


G(2) 


004EH 


PUB 


CLASHNODEBASE 


G(2) 


0060H 


PUB 


COCONN 


G(2) 


015AB 


PUB 


COHMENTSCONTROL 


G(2) 


0171H 


PUB 


CURRENTOVERLAYNU 
-M 
DEFAULTPRTFILENA 


G(2) 


0173H 


PUB 


DEBUGTOGGLE 


G(2) 


00A7H 


PUB 


G(2) 


0062H 


PUB 


EXCEPTION 


G(2) 


0048H 


PUB 


FANODEBASE 


G(2) 


006EU 


PUB 


FBLOCKBASE 


G(2) 


006AH 


PUB 


FBLOCKLISTHEAD 


G(2) 


006CH 


PUB 


FBLOCKLISTTAIL 


G(2) 


13DH 


PUB 


FBLOCKSEQUENCENU 
-MBER 


G(2) 


004AH 


PUB 


FBNODEBASE 


G(2) 


0046H 


PUB 


FDNODEBASE 


G(2) 


0044H 


PUB 


FENODEBASE 


G(2) 


0040H 


PUB 


FFNODEBASE 


G(2) 


0034H 


PUB 


FIRSTBNODEP 


G(2) 


0O28H 


PUB 


FIRSTEXNODEP 


G(2) 


002CH 


PUB 


FIRSTGRNODEP 


G(2) 


001CH 


PUB 


FIRSTNMNODEP 


G(2) 


0030H 


PUB 


FIRSTOVNODEP 


G(2) 


0050H 


PUB 


FIRSTRENAMEBLOCK 


G(2) 


0020H 


PUB 


FIRSTSGNODEP 


G(2) 


0024H 


PUB 


-P 
FIRSTTDNODEP 


G(2) 


0038H 


PUB 


GRNODEBASE 


G(2) 


0B4CH 


PUB 


H1GHESTDATAL0CAT 
-ION 



MODULE 


NAME = 


ROOT 












BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


G(2) 


0F90H 


SYM 


MEMORY 


G(2) 


OOOOH 


SYM 


COPYRIGHT 


G(2) 


0016b 


SYM 


BUFLEN 


G(2) 


0018H 


SYM 


BUFBASE 


G(1) 


00F7B 


SYM 


ERROR 


GO) 


OOFEH 


SYM 


WARNING 


G(2) 


001AB 


SYM 


LASTNMNODEP 


G(2) 


001CH 


SYM 


FIRSTNMNODEP 


G(2) 


001EH 


SYM 


LASTSGNODEP 


G(2) 


0020H 


SYM 


FIRSTSGNODEP 


G(2) 


0022H 


SYM 


LASTTDNODEP 


G(2) 


0O24H 


SYM 


FIRSTTDNODEP 


G(2) 


0U26B 


SYM 


LASTEXNODEP 


G(2) 


0O26H 


SYM 


FIRSTEXNODEP 


G(2) 


002AB 


SYM 


LASTGRNODEP 


G(2) 


002CH 


SYM 


FIRSTGRNODEP 


G(2) 


002Eh 


SYM 


LASTOVNODEP 


G(2) 


0030H 


SYM 


FIRSTOVNODEP 


G(2) 


0032H 


SYM 


LASTBNODEP 


G(2) 


0O34H 


SYM 


FIRSTBNODEP 


G(2) 


0036b 


SYM 


SGNODEBASE 


G(2) 


0038H 


SYM 


GRNODEBASE 


G(2) 


003AH 


SYM 


SYNODEBASE 


G(2) 


003CH 


SYM 


NMNODEBASE 


G(2) 


003EB 


SYM 


IDNODEBASE 


G(2) 


0040H 


SYM 


FFNODEBASE 


G(2) 


0042H 


SYM 


OVNODEBASE 


G(2) 


0044H 


SYM 


FENODEBASE 


G(2) 


0046H 


SYM 


FDNODEBASE 


G(2) 


0048H 


SYM 


FANODEBASE 


G(2) 


004AH 


SYM 


FBNODEBASE 


G(2) 


004CH 


SYM 


BNODEBASE 


G(2) 


004EH 


SYM 


CLASBNODEBASE 


G(2) 


0050H 


SYM 


FIRSTRENAMEBLOCK 



Figure 2-5 . LINK86 Symbol Table 
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G(2) 


01A4H 


SYM 


S1GN0NMSG 


GO) 


0T74H 


SYM 


PRINTNAME 


G(1) 


01A3H 


SYM 


1NITIALIZEINPUT 


GO) 


OlASh 


SYM 


OPENFBLOCKFILE 


G(1) 


01F6H 


SYM 


CLOSEFBLOCKFILE 


GO) 


0OF7H 


LIN 


7 


G(l) 


OOF AH 


LIN 


10 


GO) 


0OFEH 


LIN 


11 


G(1) 


0101H 


LIN 


14 


GO) 


0105H 


LIN 


73 


G(1) 


0108H 


LIN 


75 


GO) 


010FH 


LIN 


76 


GO) 


01 18H 


LIN 


77 


GO) 


011DH 


LIN 


78 


G(1) 


0126H 


LIN 


79 


GO) 


012AH 


LIN 


80 


G(1) 


012DH 


LIN 


81 


GO) 


0136H 


LIN 


85 


G(1) 


013DH 


LIN 


86 


GO) 


0144H 


LIN 


87 


G(1) 


0151H 


LIN 


88 


GO) 


015AH 


LIN 


89 


GO) 


0168H 


LIN 


90 


GO) 


0170H 


LIN 


91 


GO) 


0174H 


LIN 


94 


GO) 


0177H 


LIN 


96 


GO) 


018EH 


LIN 


97 


GO) 


0198H 


LIN 


98 


GO) 


019FH 


LIN 


99 


GO) 


01A3H 


LIN 


100 


GO) 


0U6H 


LIN 


103 


GO) 


01A8H 


LIN 


105 


GO) 


01ABH 


LIN 


106 


GO) 


01BEH 


LIN 


107 


GO) 


01C6H 


LIN 


108 


GO) 


01CFH 


LIN 


109 



REFERENCES TO SEGMENT BASES EXIST IN INPUT MODULES: 
ROOT 



Figure 2-5. LINK86 Symbol Table (Cont'd.) 



BASE is usually a symbolic group or segment index. If the base is the stack, then 
STACK is used instead of the index. 

OFFSET is a four-digit hexadecimal number that is the offset of the symbol or line 
from BASE, or from the current BP for stack symbols. 

TYPE describes the kind of symbol it is. There are four possible entries in the TYPE 
column: 

B A S based on an other symbol' s value 

LIN line (not a symbol) 

PUB public symbol (alphabetized within each separate BASE) 

SYM local symbol 

SYMBOL refers to the name of the symbol or number of the line. If the 
SYMBOLCOLUMNS value is one, this field is 40 characters wide. Otherwise, this 
field is 16 characters wide. If the symbol name is longer than the width of the field, 
then the name is hyphenated and continued on the next line. 

If there are any references to segment bases in the input modules (if the output 
module is an LTL program), LINK86 prints the following message at the bottom of 
figure 2-5. The message identifies all input modules containing such references. 
These references are to be resolved by the system loader or LOC86. 

Error Messages 

The warning messages are listed consecutively as warning situations are 
encountered. They may appear before or after the link map. Errors always terminate 
processing — an error message will always be the last line in the print file. 

See the discussion of the interpretation of individual messages in Appendix C. 
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CREF86 scans 8086 object modules to provide a cross-reference among external and 
public symbols in multiple modules. CREF86 accepts a list of files and controls as 
input and produces one output file: a print file. 

Figure 3-1 illustrates the types of input accepted and output produced. The input 
modules may include one or more of the following 8086 object modules: 

• Unlinked modules from one or more translators 

• Library files or specific library modules 

• Linked modules 

The output file consists of information about files and modules, plus an 
alphabetically sorted list of external and public symbols. Information printed for 
each symbol includes the name of the module defining the symbol and the name(s) 
of the module(s) declaring the symbol as external. 

This chapter provides details concerning the CREF86 invocation, controls, and 
cross-reference listing. For definition of file-naming and syntax notation conven- 
tions used in this chapter, refer to Notational Conventions following the Preface. 
For a summary of the CREF86 controls and information on error and warning 
messages which may be produced, refer to Appendix E. For details concerning 
CREF86 symbol table space limitations, refer to Appendix C. 



TRANSLATED 

OBJECT 

MODULE(S) 



LIBRARY 
MODULE(S) 



LINKED 

OBJECT 

MODULE(S) 



INVOCATION 
LINE CONTROLS 

J..., 



-*\ CREF86 



I..-----. J 



I 



PRINT FILE 
"CRF" 



CONSOLE 
MESSAGES 



Figure 3-1 . CREF86 Input and Output Files 
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CREF86 Invocation Line 

The general syntax for invocation is: 

[directory-name] C R E F 8 6 input list[con trols] 

The input list is one or more modules to be scanned for external-public cross- 
references: 

pathname[(.module name[, ...])][, ...] 

Unless a module name is specified, all modules in a pathname are included in the 
cross-reference listing produced. If the pathname is a library file, any modules 
named in parentheses are included in the cross-reference listing, even if they do not 
contain public symbol definitions for external symbols declared elsewhere in the 
input list. 

Either all or none of the pathnames may contain overlay records (produced by 
LINK86 with the OVERLAY control). If the input modules do contain overlay 
records, the first file named in the invocation is considered to be the root file; the 
rest are treated as overlays. 

The controls can be any subset of the controls described in the next section. 



CREF86 Controls 



The controls specify cross-reference listing attributes such as print file name, the 
title at the top of each listing page, and the amount of information printed on each 
page. The controls are described in table 3-1 . 



Table 3-1 . Summary of CREF86 Controls 



Control 


Abbrev. 


Default 


PAGELENGTH(numfcer) 


PL 


PAGELENGTH(60) 


PAGEWIDTH(nwm^er) 


PW 


PAGEWIDTH(120) 


PR\HT[{pathname)] 


PR 


PRMT(first input file. CRF) 


J\JLE(character-string) 


TT 


Not applicable 



If there are multiple occurrences of any control in the invocation line, the rightmost 
occurrence governs. 

At the end of this document you will find operating system-specific examples of the 
CREF86 controls. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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PAGELENGTH 



Syntax 

PAGELENGTH (m/mfcer) 

Abbreviation 

PL 

Default 

PAGELENGTH(60) 



Definition 

PAGELENGTH specifies the number of lines to be printed on each page. The 
number must be a decimal value between 10 and 255, inclusive. 



Notes 

None 
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Syntax 

PAGEWIDTH (number) 

Abbreviation 

PW 

Default 

PAGEWIDTH(120) 

Definition 

PAGEWIDTH specifies the maximum number of characters to be printed on a 
single line. The number must be a decimal value from 80 to 132, inclusive. 

Notes 

• PAGEWIDTH truncates the TITLE if TITLE is greater than the number of 
unused character locations on the title line. 

• If the specified PAGEWIDTH does not allow enough space to print the 
referring module name(s) on the same line as the defining module name, the 
referring module names(s) will be printed on separate lines. 
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PRINT 



Syntax 

PRINT[(patfmame)] 

Abbreviation 

PR 

Default 

P R I N T {first input file . C R F ) 

Definition 

PRINT provides the ability to specify a pathname for the cross-reference listing. 
The pathname identifies the destination of the listing. If the PRINT control is not 
specified or if the control is given without an argument, the print file will have the 
same pathname as the first file in the input list, except the extension will be .CRF. 



Notes 



If no PRINT control is specified, output goes to a default file. The name of the 
default file is the name of the first file in the invocation command with the 
extension .CRF. 

If PRINT is specified with no pathname, output goes to the default file. 
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Syntax 

TITLE (character string) 

Abbreviation 

TT 

Default 

Not applicable 

Definition 

TITLE may be used to specify a heading having a character string of null to 80 
characters, inclusive. This heading appears on the first line of every page of the 
cross-reference listing. 



Notes 



The TITLE string is truncated if the PAGEWIDTH control is not large enough 
to accommodate the entire string. 

If the character string contains any characters defined by the operating system 
as special, the string must be delimited in accord with operating system conven- 
tions for special characters and string delimiters. 
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CREF86's Print File 

The print file is a cross-reference listing of external and public symbols in the input 
modules. This listing consists of the following parts: 

• A header 

• Warnings (if any) 

• Module list 

• Cross-reference information 



Header 

Figure 3-2 illustrates the components printed in this part of the cross-reference 
listing: 

• A title line output by CREF86, usually consisting of a program identifier 
(CREF86), any user-defined TITLE, date of listing, and the page number 

• A line identifying the CREF86 environment (operating system and version 
number) 

• One or more lines summarizing the pathnames of input files 

• A line for identifying the print file pathname 

• One or more lines giving the controls specified at invocation, present only if 
controls were specified 



Warnings 

Figure 3-3 illustrates how warning messages appear on the cross-reference listing 
when CREF86 detects such conditions as mismatched types, modules not found, etc. 
Refer to Appendix E for information on CREF86 error and warning messages. 



CREFB6 EXAMPLfe. OF 


CROSS REFERENCE USING CREF66 








UM/DD/YY 


t>AG£ 1 


system-id CftBFSo Vx.y 














INPUT FILES: 

OUTPUT FILE: 
CONTROLS SPECIFIED: 


pathnamel pathname2 

pattmame7 pathnames 

pathnameU pathnameU 

pathnamelS 

PR(OUT) TT(EXAMPLE OF CROSS 


pathname3 
pathnames 
pathnamelS 

REFERENCE USING 


pathname* 
pathnamel 
pathnamelS 

CREF86) Ph(120) 


PL(60) 


pathnames 
pathnamel 1 
pathnamel? 


pathnames 
pathname12 


^^ 





Figure 3-2. Header of Cross-Reference Listing 



HARKING 19: TYPE MISMATCH 

FILE: pathnamelS 

MODULE: MISMATCH 

SYMBOL : ENAMEID 
WARNING 19: TIPS MISMATCH 

FILE: pathnamelS 

MODULE: MISMATCH 

SYMBOL: FOUR 
WARNING 20: SPECIFIED MODULE NOT FOUND 

FILE: pathnamelS 

MODULE: UNKB0WN_M0DULE 



Figure 3-3. Warning Messages on CREF86 Listing 
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Module List 

The module list, shown in figure 3-4, is a tabulated summary of all input files and 
corresponding modules included from these files. 

After the module list is printed, the rest of the page is skipped, so that the symbol 
cross-references begin on the next new page. 













____--^ 


^ — ■ 




MODULES INCLUDED: 








FILE NAME 


MODULE NAME(S) 










pathnamel 


CKEF86 










pathname2 


PARSE 










pathnames 


SIGNON 










pathname4 


NEXTSTATE 










pathname5 


ERROR 










pathnames 


UTILITIES 










pathname7 


MEMORYMANAGEMENT 










pathnames 


SCANMODULES 










pathnames 


PROCESSRECORDS 










pathnamelO 


SCANUTIL1TIES 










pathnamel 1 


LISTOUTPUT 










pathname12 


LISTUT1LITIES 










pathnamel! 


SYMBOLSORT 










pathnameU 


OBJMAN 










pathnamel 5 


MISMATCH 










pathnameW 












pathname17 


DQ ALLOCATE 


DQATTACH 


DQCHANGEEXTENSION 


DQCREATE 


DQDECODEEXCEPTION 




DQDETACH 


DQEXIT 


DQFREE 


DQGE-TARGUMENT 


DQGETSYSTEMID 




DQGETTIME 


DQOPEN 


DQREAD 


DQSEEK 


DQtiRITE 




SYSTEMSTACK 











Figure 3-4. Module List on CREF86 Listing 



Symbol Cross-Reference Information 

Figure 3-5 illustrates the format for listing data for all external and public symbols 
referenced in the Module List. 

The first column contains the names of the external and public symbols, in 
alphabetical order. 

The second column identifies the type of each symbol, as declared in the external or 
public reference. The following tabulation identifies the entries which may occur in 
this column: 

CREF86 Entry Symbol Type 



BYTE 

WORD 

DWORD 

LUORD 

INTEGER(n) 

REAL(n) 

POINTER 

STRUCTURE 

ARRAY OF 

UNKNOWN 

FILE 

LABEL 

PROCEDURE 

(NEAR, FAR) 
CONSTANT 
SELECTOR 

The symbol type that appears in the second column is that associated with the first 
occurrence of that symbol in the input list. 



8-bit unsigned 
16-bit unsigned 
32-bit unsigned 
64-bit unsigned 
n = 1,2, 4, or 8 bytes 
n = 1,2, 4, or 8 bytes 



null 
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CREF86 EXAMPLE OF CBOSS REFERENCE USING CREF86 

SYMBOL NAME SYMBOL TYPE 

ACCESS_PAGE UNKNOWN 

ALLOCATE UNKNOWN 

APPENDNODE PROCEDURE NEAR 

APPENDODSMNODE PROCEDURE NEAR 

ARRAIBASE POINTER 

ATOI PROCEDURE WORD NEAR 

BTOZ PROCEDURE WORD NEAR 

BOBBLESORTYABNAMES. . . . PROCEDURE NEAR 

BUMPLINECOUNT PROCEDURE NEAR 

CBECKHEADER PROCEDURE NEAR 

CHECKOTERLAY PROCEDURE NEAR 

CBECEVARTIPE PROCEDURE BYTE NEAR 

CMPNAMES PROCEDURE BYTE NEAR 

CMPSTRNGS PROCEDURE BYTE NEAR 

CBCTI MORD 

CNCTO WORD 

COMTROLIDCOORDINATE . . . NORD 

CONTROLOFFSETCOORDINATE . BYTE 

CONTROLSARESPECIFIED. . . BYTE 

CREATEOBJECT PROCEDURE WORD NEAR 

CURRENTOVLNUM BYTE 

CURRENT_PAGE UNKNOWN 

DEBUGTOGGLE BYTE 

DEBUGTOGGLE BYTE 

DQALLOCATE PROCEDURE WORD NEAR 

DQATTACH PROCEDURE WORD NEAR 

DQCHANGEEXTENSION .... PROCEDURE NEAR 

DQCREATE PROCEDURE WORD NEAR 

DQDECODEEXCEPTION .... PROCEDURE NEAR 

DQDETACH PROCEDURE NEAR 

DQEXIT PROCEDURE NEAR 

DQFREE PROCEDURE NEAR 

DQGETARGUMENT PROCEDURE BYTE NEAR 

DQGETSXSTEMID PROCEDURE NEAR 

DQGETTIME PROCEDURE NEAR 



DEFINING MODULE; REFERRING MODULE(S) 



OBJ MAN 
OBJ MAN 
UTILITIES 
UTILITIES; 
SYMBOLSORT ; 
UTILITIES; 



PROCESSRECORDS 



UTILITIES; 

SYMBOLSORT; 

LISTUTIL1TIES; 

SCANUTILITIES; 

SCANUTILITIES; 

SCANUTILITIES; 

LISTUTILITIES; 

UTILITIES; 

UTILITIES; 

UTILITIES; 

PARSE; 

PARSE; 

PARSE; 

OBJMAN ; 

PROCESSRECORDS; 
OBJMAN 



PARSE SCANhODULES 

LISTOUTPUT 

PARSE 

LISTUTILITIES 

LISTOUTPUT 

LISTOUTPUT 

SCANMODULES 

SCANMODULES 

PROCESSRECORDS 

SYMBOLSORT 

NEXTSTATE SCANMODULES SCANUTILITIES 

MISMATCB 

SIGNON ERROR MISMATCH 

UTILITIES 

UTILITIES 

UTILITIES 

PARSE SCANMODULES PROCESSRECORDS 

SCANUTILITIES SYMBOLSORT 

SCANUTILITIES 



PARSE; ERROR 

"••DUPLICATE DECLARATION"**: 



MISMATCH 



DQALLOCATE; 

DQATTACH; 

DQCHANGEEXTENSION ; 

DQCREATE; 

DQDECODEEXCEPTION ; 

DQDETACH; 

DQEXIT; 

DQFREE; 

DQGETARGUMENT; 

DQGETSYSTEMID; 

DQGETTIME; 



MEMORYMANAGEMENT SYMBOLSORT OBJMAN 

UTILITIES SCANUTILITIES 

PARSE 

UTILITIES 

ERROR 

SCANMODULES 

CREF86 ERROR 

LISTOUTPUT 

PARSE 

SIGNON 

LISTOUTPUT 



Figure 3-5 . Symbol Cross-Ref erence Information 



The third column contains the following for each symbols listed: 

• The name of the module in which the symbol is defined public (defining 
module) 

• A semicolon (;), if there are external references to the symbol in any of the input 
modules 

• The name(s) of the modules(s) in which the symbol is declared external 
(referring module(s)) 

The third column is also used to flag unresolved and duplicate references. In the case 
of unresolved external references, the string ***UNRESOLVED*** appears before 
the semicolon. In the case of duplicate references, i.e., when a symbol has two or 
more public definitions, the first public declaration is considered legal, and the rest 
are flagged as duplicates. The string ***DUPLICATE DECLARATION*** 
appears, followed by a colon (:) and the name of the module containing the 
duplicate public declaration. 

If the input files contain overlays, CREF86 produces a symbol cross-reference that 
consolidates all the symbols from all overlay and root modules. The first file in the 
input list is considered to be the root file. CREF86 distinguishes between public 
symbols with the same name in different overlays and does not flag these symbols as 
duplicates. However, CREF86 does flag duplicate public declarations within any 
one root/overlay combination. 
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CHAPTER 4 
LIB86 



LIB86 allows you to create, modify, and examine library files. It is an interactive 
program. 

This chapter provides details concerning LIB86 invocation and commands. For 
definition of file-naming and syntax notation conventions used in this chapter, refer 
to Notational Conventions following the Preface. For a summary of the LIB86 com- 
mands and information on error and warning messages that may be produced, refer 
to Appendix F. For details concerning LIB86 symbol table space limitations, refer to 
Appendix C. 



LI B86 Invocation 

The general syntax for the invocation line is: 
[directory-name] L I B 8 6 [comment] 

LIB86 Commands 



Once LIB86 has begun execution, it displays an asterisk (*) and waits for a com- 
mand. Table 4-1 lists all of LIB86's commands. 



Table 4-1 . Summary of LIB86 Commands 



Command 


Abbrev. 


Description 


ADD ipathname[(module name [,...])]> 
[,...] TO pathname 


A 


Adds modules to a library 


CREATE pathname 


C 


Creates library files 


DELETE pathname(module name [,...]) 


D 


Deletes modules from a library file 


EXIT 


E 


Terminates session with LIB86 


LIST <.pathname[{module name [,...])]> 
[,...] [TO pathname] [PUBLICS] 


L 
[P] 


Lists modules contained in a library 
file, and optionally lists all publics 



At the end of this document you will find operating system-specific examples of the 
LIB86 commands. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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A r\ Q iAPX 86,88 Family Utilities 

Syntax 

ADD ipathname1[( module name[,. ..])]>[, ...]T0 pathname2 

Abbreviation 

A 

Definition 

ADD adds modules to a library file. 

The pathnamel can be an object file or a library file. 

The pathname2 is the destination library file. The library must exist before the ADD 
command is given; it may contain other modules. 

If pathnamel is an object file produced by a translator, LINK86, or LOC86, then all 
modules contained within the object file will be added to the designated library. 

If path nam e2 is a library file, it may be specified with or without the module name 
list. If no module name list is specified, all modules contained in the source library 
will be added to the destination library. If the module name list is specified, then 
only the modules specified within the parentheses are added to the destination 
library. 
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iAPX 86,88 Family Utilities 



CREATE 



Syntax 

CREATE pathname 

Abbreviation 

C 

Definition 

CREATE creates a library file with the specified pathname. 

Notes 

• If a file with the specified pathname already exists, the library will not be 
created and an error message will be provided. 
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Syntax 

DELETE pathname (.module name [,...]) 

Abbreviation 

D 

Definition 

DELETE removes modules from a library file. Modules can be deleted from only 
one library at a time. 

Notes 
None 
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iAPX 86,88 Family Utilities EXIT 

Syntax 
EXIT 

Abbreviation 
E 

Definition 

EXIT terminates a session with LIB86 and returns control to the operating system. 

Notes 

• LIB86 disassembles libraries into an internal form. The library is not 
reconstituted until the EXIT command is processed. Therefore significant I/O 
will take place following an EXIT command. 



4-5 



I I QT iAPX 86,88 Family Utilities 

Syntax 

LIST ipathname1[( module name [,...])]} [,...] [TO pathname2] 
[PUBLICS] 

Abbreviation 

L [P] 

Definition 

LIST prints the names of modules, and optionally the public symbols contained in 
those modules, to the specified output pathname. 

The pathnamel is the library whose modules are to be listed. 

The module name, if specified, identifies the modules to be listed. 

TO pathname2 identifies the device or file to receive the listing. If it is not specified, 
the listing is directed to the console output device. 

PUBLICS indicates that, in addition to the module names, all public symbols con- 
tained within the module will also be listed. PUBLICS may be abbreviated as 'P'. 

Notes 

None 
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CHAPTER 5 
LOC86 



LOC86 changes a relocatable 8086 object module into an absolute object module. 
As figure 5-1 illustrates, LOC86 takes a single 8086 object module as input and out- 
puts a located object file and, optionally, a print file. The print file output contains 
diagnostic information. The object file contains absolute object code. 

This chapter provides details concerning the LOC86 invocation, controls, and print 
file. For definition of file-naming and syntax notation conventions used in this 
chapter, refer to Notational Conventions following the Preface. For a summary of 
the LOC86 controls and information on error and warning messages that may be 
produced, refer to Appendix G. For details concerning LOC86 segment support 
capabilities, refer to Appendix C. 

INVOCATION 
LINE CONTROLS 



OBJECT 
MODULE 



L> 



*1 



LOC86 



_, J 



ABSOLUTE 
OBJECT 
MODULE 



CONSOLE 
MESSAGES 



PRINT 
FILE 
\MP2" 



Figure 5-1 . LOC86 Input and Output Files 
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LOC86 Invocation Line 

the general syntax for the invocation line is: 
[directory-name] LOC 86 input fife [TO object fUe][controls] 

The input file is a file containing an object module to be located. It is usually, but 
not necessarily, the output from LINK86. 

TO object file specifies the file to receive the located object module. In most cases 
this is an executable file. If object file is not specified, then output will be directed to 
a file that has the same pathname as the input f He, except it will have no extension. 

The controls may be any subset of the controls described in the next section. 

LOC86 Controls 

The controls are described in table 5-1 . 

If you specify the same control more than once in the same invocation line, only the 
last version entered counts. For example, if you enter NOMAP, and then later 
decide you want a locate map, you can enter the MAP control without error. The 
second version of the control is recognized and the first is ignored. 

At the end of this document you will find operating system-specific examples of the 
LOC86 controls. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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LOC86 



iAPX 86,88 Family Utilities 



Table 5-1 . Summary of LOC86 Controls 



Control 


Abbrev. 


Default 


ADDRESSES* 

iSEGMEUJS(isegment[\class[\overlay]] 
{addr)y[,...]) \ 
CLASSES(-Cc/ass(adrfr)>[,...]) I 
GRO\JPS{igroup(addr)y[,...]) > 
[.-]) 


AD 

(SM| 

CS|GR) 


Not applicable 


BOOTSTRAP 


BS 


Not applicable 


COMMENTS 


CM 


COMMENTS 


NOCOMMENTS 


NOCM 


\miCODE[(address)] 


IC 


INITCODE(200H) 


NOINITCODE 


NOIC 


LINES 


LI 


LINES 


NOLINES 


NOLI 


MAP 


MA 


MAP 


NOMAP 


NOMA 


NAMEfmodu/e) 


NA 


Not applicable 


0BJECTC0NTROLS( 

{LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS | NOPUBLICS | 
PURGE | NOPURGE>[,...]) 


OC 


Not applicable 


ORDER( 

■CSEGMENTS«:seg/ne/7/[ \c/ass[\ overlay]}} 

[.-1)1 
Cl/KSSES({class[(segment [,...])]> [,...])> [,...]) 


OD 
(SM|CS) 

CS 


Not applicable 


PR\UJ[{pathname)] 


PR 


PRINT(obyecfff/e.MP2) 


NOPRINT 


NOPR 


PRINTCONTROLS({ LINES | NOLINES | 

COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS | NOPUBLICS 1 
PURGE | NOPURGE>[,...]) 


PC 


Not applicable 


PUBLICS 


PL 


PUBLICS 


NOPUBLICS 


NOPL 


PURGE 


PU 


NOPURGE 


NOPURGE 


NOPU 


RESERVE* iaddr TO addr> [,...]) 


RS 


Not applicable 


SEQS\ZE(isegment[\class[\overlay]] 
(size)y [,...]) 


SS 


Not applicable 


STA RT( {symbol \ paragraph ,offseO) 


ST 


Not applicable 


SYMBOLS 


SB 


SYMBOLS 


NOSYMBOLS 


NOSB 


SYMB0LC0LUMNS(-C1I2I3I4}) 


SC 


SYMBOLCOLUMNS(2) 
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iAPX 86,88 Family Utilities A D D R ESSES 

Syntax 

A D D R E S S E S ({ S E G M E N T S ( {segment name[ \class name 

[\ overlay name]] (address) > 

CLASSES ({class name (.address) }[,...]) | 
GROUPS ({group name (addr ess) }[, ...]) } 

) 

Abbreviation 
AD (SM | CS | GR> 

Default 

Not applicable 

Definition 

ADDRESSES allows you to override LOC86's default address assignment 
algorithm. You may assign a beginning address to segments, classes, or groups. All 
addresses must follow Intel rules for integer representation. (These rules are the 
same as those used by ASM86 and PL/M-86.) The subcontrols, SEGMENTS, 
CLASSES, and GROUPS, identify exactly what elements of the input module are 
being assigned addresses. When assigning an address with the SEGMENTS sub- 
control, you may also specify the class name and overlay name of the particular 
segment. 

LOC86 attempts to detect and avoid conflicts whenever possible. If the specified 
address does not agree with the alignment attribute of the specified segment or the 
first segment in the specified class, then the address is ignored. If an absolute seg- 
ment is located at the address assigned to a class, then the class begins at the first free 
address after the absolute segment. If you assign a non-paragraph address to a 
group, LOC86 will assign the first paragraph address below the specified address. 



Notes 



The subcontrols SEGMENTS, CLASSES, and GROUPS can be specified 
multiple times in a single ADDRESSES control. 

If an address assignment causes a conflict with an ORDER control, a 
RESERVE control or an absolute segment, LOC86 generates an error message. 

When locating bound object modules, you may not assign an address to a 
segment in a group. 
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BOOTSTRAP 



iAPX 86,88 Family Utilities 



Syntax 

BOOTSTRAP 

Abbreviation 

BS 

Default 

Not applicable 

Definition 

BOOTSTRAP indicates that the code for a long jump to the module's start address 
should be placed at location OFFFFOH, when the module is loaded. This is the first 
instruction executed by the 8086 after reset. If the input module has no start address 
and none is specified in the START control, LOC86 will generate an error message. 

Notes 

• See also the START and INITCODE controls . 
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iAPX 86,88 Family Utilities 



Syntax 

COMMENTS 
NOCOMMENTS 



COMMENTS/NOCOMMENTS 



Abbreviation 

CM 
NOCM 



Default 

COMMENTS 

Definition 

COMMENTS allows object file comment records to remain in the output module. 
The NOCOMMENTS control removes all comment records except those designated 
as non-purgable. 

Comment records are added to the object module for various reasons. All 
translators add a comment record to the object files they produce. The record iden- 
tifies the compiler or assembler that produced the object file. 

Comment records are superfluous to the production of executable code and may be 
removed at any time during the development process, or left in the file. 



Notes 

• See PRINTCONTROLS, OBJECTCONTROLS, and PURGE. 

• Comment records should not be removed when you submit an object file in a 
Software Problem Report. 

• NOCOMMENTS will decrease the size of the output object module. 

• COMMENTS has no effect on the print file. 
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INITCODE/NOINITCODE 



iAPX 86,88 Family Utilities 



Syntax 

INITCODE[(aoWress) 
NOINITCODE 



Abbreviation 

IC 
NOIC 



Default 

INITCODE(200H) 

Definition 

INITCODE causes LOC86 to create a new segment that contains code to initialize 
the segment registers. The optional address argument specifies the physical address 
of the code that performs this initialization. If no address is specified, the initializa- 
tion code will be placed at 200H. The equivalent assembly language code is shown 
below: 



STACKFRAME 


DW 


stack frame 


DATAFRAME 


DU 


data frame 


EXTRAFRAME 


DU 
CLI 


extra frame 




MOV 


SS, CS:STACKFRAME 




MOV 


SP, stack offset 




MOV 


DS, CS:DATAFRAME 




MOV 


ES, CS:EXTRAFRAME 




JMP 


program start 



Notes 



The initialization code segment is created only if a register initialization record 
for 8086 segment registers exists in the input. These register initialization 
records are automatically produced by 8086-based translators for main 
modules. 

If the area of memory used by the INITCODE default is reserved, LOC86 
places the initialization code above the reserved space. 

If created, the new segment is called ??LOC86_INITCODE. 
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iAPX 86,88 Family Utilities LINES/NOLINES 



Syntax 

LINES 
NOLINES 



Abbreviation 

LI 
NOLI 



Default 

LINES 

Definition 

LINES allows line number information to remain in the object file. In-circuit 
emulators and other debuggers use this information; it is not needed to produce 
executable code. The NOLINES control removes this information from the output 
file. 



Notes 



The scope of the LINES control can be modified with PRINTCONTROLS and 
OBJECTCONTROLS. 

See the PURGE control. 

NOLINES will decrease the size of the output object file. 
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MAP/NOMAP iAPX 86,88 Family utilities 

Syntax 

MAP 
NOHAP 

Abbreviation 

MA 
NOMA 

Default 

MAP 

Definition 

MAP causes LOC86 to produce a locate map for the output module and add it to the 
print file. For all segments in the module the map shows the complete name (seg- 
ment name, class name, and overlay name), size, alignment, start address, and stop 
address. A more complete description of the locate map and the rest of the print file 
is at the end of this chapter. 

Notes 

• MAP can be overridden by the NOPRINT control. 
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Syntax 

N A M E ( module name ) 

Abbreviation 

NA 

Default 

Module retains its current name. 

Definition 

NAME assigns the specified module name to the output module. If NAME is not 
specified, then the output module retains its current name. 

The module name may be up to 40 characters long. It may be composed of any of 
the following characters in any order: 



? (question mark) 
@ (commercial at) 
: (colon) 
. (period) 

(underscore) 

A,B,C, ...,Z 
0,1, 2,.. .,9. 

Lower case letters may be used, but they are automatically converted to upper case. 



Notes 

• NAME does not affect the output file's name, only the module name in the 
output module's header record. 
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OBJECTCONTROLS 



iAPX 86,88 Family Utilities 



Syntax 

OBJECTCONTROLSCUINES | NOLINES | 

COMMENTS | NOCOMMENTS 
SYMBOLS j NOSYMBOLS | 
PUBLICS | NOPUBLICS | 
PURGE | NOPURGE} 

) 



Abbreviation 

OC 

Default 

Controls apply to both the print file and the object file. 

Definition 

OBJECTCONTROLS causes the controls specified in its arguments to be applied to 
the object file only. Comment records, line number records, local and public symbol 
records, and symbol type records are selectively included or excluded from the 
object file. This will not affect the print file and the information contained in it. 



Notes 



If you specify an invalid control in the arguments to OBJECTCONTROLS, 
LOC86 generates an error message. 

You may specify a control or control pair more than once within 
OBJECTCONTROLS, but only the last version specified counts. 

You may abbreviate the controls used within OBJECTCONTROLS. 

When you specify a control in both OBJECTCONTROLS and 
PRINTCONTROLS, it will have the same effect as specifying it once outside of 
these controls. 
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iAPX 86,88 Family Utilities ORDER 

Syntax 

ORDER({SEGMENTS( {segment name[\class name[\overlay name]]} 
CLASSES (\{classname[(segment name [,...])]> [,...])} 

Abbreviation 
ODCSM | CS | ) 

Default 

Not applicable 

Definition 

ORDER specifies a partial or complete order for segments, classes, and the segments 
within a class. Segments and classes listed in ORDER are located before any other 
relocatable segment. 

The subcontrol SEGMENTS indicates that the list of segment names shall be 
ordered. 

The segment name identifies the specific segments to be ordered. The \ class name 
and \overlay name may be used to resolve conflicts with duplicate segment names. 
If \overlay name is specified, the \class name is required. 

If one of the segments specified is not contained in the designated group, an error 
message is generated. 

Notes 

• See "LOC86's Algorithm for Locating Segments" at the end of this chapter. 
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PRINT/NOPRINT 



Syntax 

PRINT[(patfmame)] 
NOPRINT 



Abbreviation 

PR 
NOPR 



Default 

PRINT (object fife. MP 2) 

Definition 



iAPX 86,88 Family Utilities 



PRINT allows you to direct the locate map symbol table and other diagnostic 
information to a particular file. If the PRINT control is not specified or if the con- 
trol is given without an argument, the print file will have the same pathname as the 
output file except the extension will be .MP2. NOPRINT prevents the creation of 
this file. 



Notes 

• The discussion at the end of this chapter describes the contents of the print file. 

• See also MAP, SYMBOLCOLUMNS, LINES, SYMBOLS, PUBLICS, and 
PRINTCONTROLS. 
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iAPX 86,88 Family Utilities P R I N T C O N T R O LS 

Syntax 

PRINTCONTROLSCUINES | NOLINES | 

COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS | NOPUBLICS | 
PURGE | NOPURGE} 

) 

Abbreviation 

PC 

Default 

Controls apply to both the print file and the object file. 

Definition 

PRINTCONTROLS causes the controls specified in its arguments to be applied to 
the print file only. Line number information, and local and public symbol informa- 
tion are selectively included or excluded from the print file. This will not affect the 
object file or the information contained in it. 



Notes 



If you specify an invalid control in the arguments to PRINTCONTROLS, 
LOC86 generates an error message. 

You may specify a control in OBJECTCONTROLS more than once, but only 
the last version specified counts. 

You may abbreviate the controls used within PRINTCONTROLS. 

When you specify a control in both PRINTCONTROLS and 
OBJECTCONTROLS, it will have the same effect as specifying it once outside 
of these controls. 
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PUBLICS/NOPUBLICS 



iAPX 86,88 Family Utilities 



Syntax 

PUBLICS 
NOPUBLICS 



Abbreviation 

PL 
NOPL 



Default 

PUBLICS 

Definition 

PUBLICS causes the public symbol records to be kept in the object file and the 
corresponding information to be placed in the print file. 



Notes 



The scope of PUBLICS can be modified by PRINTCONTROLS and 
OBJECTCONTROLS. 

NOPUBLICS will reduce the size of the output object file; however, public 
symbol records are used by debuggers. 

See the PURGE control. 
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iAPX 86,88 Family Utilities PURGE/NOPURGE 

Syntax 

PURGE 
NOPURGE 

Abbreviation 

PU 
NOPU 

Default 

NOPURGE 

Definition 

PURGE is exactly the same as specifying NOLINES, NOSYMBOLS, 
NOCOMMENTS, and NOPUBLICS. NOPURGE in the control list is the same as 
specifying LINES, SYMBOLS, COMMENTS, and PUBLICS. 

PURGE removes all of the public and debug information from the object file and 
the print file. It will produce the most compact object file possible. The records that 
would be included by NOPURGE are useful to debuggers and in-circuit emulators, 
but otherwise they are unnecessary for producing executable code. 



Notes 



PRINTCONTROLS and OBJECTCONTROLS can be used to modify the 
scope of PURGE. 
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Syntax 

RESERVE {{addressl TO address2} [,...]) 

Abbreviation 

RS 

Default 

All of memory is assumed available. 

Definition 

RESERVE prevents LOC86 from locating segments in certain areas of memory. 
LOC86 will not use all memory addresses from addressl to address2 inclusive; 
addressl must be less than or equal to address2. 

Notes 

• If an absolute segment uses a reserved memory area, a warning message is 
generated. 

• Reserved areas may overlap. 
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iAPX 86, 88 Family Utilities S E G S I Z E 

Syntax 

SEGSIZEC-C segmen t name [ \ class name [ \ overlay name] ] ( size ) } 
[,...]) 

Abbreviation 

SS 

Default 

Not applicable 

Definition 

SEGSIZE allows you to specify the memory space used by a segment. 

The segment name may be any segment contained in the input module. 

The size is a 16-bit number that LOC86 uses to change the size of the specified seg- 
ment. There are three ways of specifying this value: 

• + indicates that the number should be added to the current segment length. 

• — indicates that the number should be subtracted from the current segment 
length. 

• No sign indicates that the number should become the new segment length. 



Notes 



LOC86 issues a warning message when SEGSIZE decreases the size of a 
segment. 
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Syntax 

STARK {public symbol \ paragraph , offset} ) 

Abbreviation 

ST 

Default 

The start address designated in the input module 

Definition 

START allows you to specify the start address of your program. 

If you specify public symbol, that symbol must be defined within the input module. 

The paragraph value initializes the CS register and the offset value initializes the IP 
in an 8086 long jump when your program is started. 

Notes 

• See the BOOTSTRAP and INITCODE controls. 



5-18 



iAPX 86,88 Family Utilities 



Syntax 

SYMBOLS 
NOSYMBOLS 



SYMBOLS/NOSYMBOLS 



Abbreviation 

SB 
NOSB 



Default 

SYMBOLS 

Definition 

SYMBOLS specifies that all local symbol records shall be included in the object file, 
and information concerning local symbols will also appear in the symbol table con- 
tained in the print file. Local symbol records are used by debuggers and in-circuit 
emulators. 

Notes 

• The scope can be modified by OBJECTCONTROLS and PRINTCONTROLS. 

• NOSYMBOLS will decrease the size of the output object file. 

• See the PURGE control. 
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SYMBOLCOLUMNS 

Syntax 

SYMB0LC0LUMNSU1 |2|3|4>) 

Abbreviation 

SC 

Default 

SYMB0LC0LUMNS(2) 

Definition 

SYMBOLCOLUMNS indicates the number of columns to be used when producing 
the symbol table for the object module. Two columns fit on a 78-character line; four 
columns fit on a single 128-character line printer line. 

Notes 

None 



iAPX 86,88 Family Utilities 
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LOC86's Print File 

The print file is always created unless you specify NOPRINT. The optional argu- 
ment to PRINT designates the name of the print file. The default print file is the 
object file with the extension .MP2. 

The print file may contain as many as three parts: 

• A symbol table 

• A memory map 

• An error message list 

The symbol table is included in the print file when a PUBLICS, LINES, or 
SYMBOLS control is in effect. The memory map is controlled by the 
MAP/NOMAP control. Error and warning messages, if any, are always added to 
the print file. 



The Symbol Table 

LOC86 produces a symbol table when any or all of the symbol controls (LINES, 
SYMBOLS, and PUBLICS) are in effect. No symbol table will be produced when 
PURGE is in effect for the print file. 

Figure 5-2 shows LOC86's symbol table with the SYMBOLCOLUMNS set at 2 (the 
default). 

BASE is usually a 4-digit hexadecimal number that is the base address of the group 
that contains the symbol. If the base is the stack, then STACK is used instead of a 
number. If the symbol is based on another symbol's value, then the BASE and 
OFFSET values for that symbol are given. 

OFFSET is a 4-digit hexadecimal number that is the offset of the symbol or line 
from BASE, or from the current BP for stack symbols. 

To compute the physical address of the specified symbol you would use the follow- 
ing equation: 

(BASE * 10H) + OFFSET = Physical Address 

Of course, the physical address of the symbols whose base is the STACK, or symbols 
that are based on another symbol's value, cannot be computed until run-time. 

TYPE describes the kind of symbol it is. There are four possible entries in the TYPE 
column: 

B A S based on another symbol's value 

LIN line (not a symbol) 

PUB public symbol 

SYM local symbol 

SYMBOL field contains the name of the symbol or number of the line. If the 
SYMBOLCOLUMNS value is 1, this field is 40 characters wide. If the 
SYMBOLCOLUMNS value is 2 or more, then this field is 16 characters wide. If the 
symbol name is longer than the width of the entry, then the name is hyphenated and 
continued in the SYMBOL field on the next line. 
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system-id 8Q86 LOCATER, Vx.y 

INPUT FILE: pattmamel 

OUTPUT FILE: pathname2 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 

DATE: MM/DD/YY TIME: HH:MM:SS 



SYMBOL TABLE OF MODULE ROOT 



OFFSET TYPE SYMBOL 



00EBH 


016CH 


PUB 


BINDCONTROL 


OOBBh 


001EH 


PUB 


BOFBASE 


O0BBH 


0054H 


PUB 


CLASHNODEBASE 


OOBBH 


0160H 


PUB 


COMMENTSCONTROL 


OOBBH 


0179H 


PUB 


DEBUGTOGGLE 


OOBBH 


0O68H 


PUB 


EXCEPTION 


OOBBH 


0074H 


PUB 


FBLOCKBASE 


OOBBH 


0O72H 


PUB 


FBLOCKLISTTAIL 


OOBBH 


0050H 


PUB 


FBNODEBASE 


OOBBH 


004AH 


PUB 


FENODEBASE 


OOBBH 


0O3AH 


PUB 


FIRSTBNODEP 


OOBBH 


0O32H 


PUB 


FIBSTGRNODEP 


OOBBH 


B036H 


PUB 


FIRSTOVNODEP 


OOBBH 


0O26H 


PUB 


FIRSTSGNODEP 


OOBBH 


0O3EH 


PUB 


GRNODEBASE 



BASE 


OFFSET 


TYPE 


SYMBOL 


OOBBH 


0052H 


PUB 


BNODEBASE 


OOBBH 


001CH 


PUB 


BUFLEN 


OOBBH 


0066H 


PUB 


COCONN 


OOBBH 


0177H 


PUB 


CURRENTOVERLAYNU 
-M 
DEFAULTPRTFILENA 


OOBBH 


OOADH 


PUB 








-ME 


OOBBH 


004EH 


PUB 


FANODEBASE 


OOBBH 


0070H 


PUB 


FBLOCKLISTHEAD 


OOBBH 


0143H 


PUB 


FBLOCKSEQUENCENU 
-MBER 


OOBBH 


004CH 


PUB 


FDNODEBASE 


OOBBH 


0046H 


PUB 


FFNODEBASE 


OOBBH 


002EH 


PUB 


FIRSTEXNODEP 


OOBBH 


0022H 


PUB 


FIRSTNMNODEP 


OOBBH 


0056H 


PUB 


FIRSTRENAMEBLOCK 
-P 
FIRSTTDNODEP 


OOBBH 


002AH 


PUB 


OOBBH 


0B52H 


PUB 


HIGHESTDATALOCAT 
-ION 



OFFSET TYPE SYMBOL 



OFFSET TYPE SYMBOL 



OOBBH 


OFAOH 


STM 


MEMORI 


OOBBH 


O0O6H 


SYM 


COPYRIGHT 


OOBBH 


0O1CH 


SIM 


BUFLEN 


OOBBH 


001EH 


SYM 


BUFBASE 


0020H 


0OF7H 


STM 


ERROR 


0020H 


OOFEH 


SYM 


WARNING 


OOBBH 


0020H 


SYM 


LASTNMNODEP 


OOBBH 


0022H 


SYM 


FIRSTNMNODEP 


OOBBH 


0024H 


SIM 


LASTSGNODEP 


OOBBH 


0026H 


SYM 


FIRSTSGNODEP 


OOBBH 


0O28H 


SYM 


LASTTDNODEP 


OOBBH 


002AH 


SYM 


FIRSTTDNODEP 


OOBBH 


002CH 


SIM 


LASTEXNODEP 


OOBBH 


002EH 


SYM 


FIRSTEXNODEP 


OOBBH 


0O3OH 


SIM 


LASTGRNODEP 


OOBBH 


0032H 


SYM 


FIRSTGRNODEP 


OOBBH 


0034H 


SIM 


LASTOVNODEP 


OOBBH 


0036H 


SYM 


FIRSTOVNODEP 


OOBBH 


0038H 


SIM 


LASTBNODEP 


OOBBH 


003AH 


SYM 


FIRSTBNODEP 


OOBBH 


0O3CH 


SIM 


SGNODEBASE 


OOBBH 


003EH 


SYM 


GRNODEBASE 


OOBBH 


0040H 


SIM 


SINODEBASE 


OOBBH 


0042H 


SYM 


NMNODEBASE 


OOBBH 


0044H 


SIM 


TDNODEBASE 


OOBBH 


0046H 


SYM 


FFNODEBASE 


OOBBH 


0048H 


SIM 


OVHODEBASE 


OOBBH 


004AH 


SYM 


FENODEBASE 


OOBBH 


004CH 


SIM 


FDNODEBASE 


OOBBH 


004EH 


SYM 


FANODEBASE 


OOBBH 


0050H 


SIM 


FBNODEBASE 


OOBBH 


0052H 


SYM 


BNODEBASE 


OOBBH 


0054B 


SYM 


CLASHNODEBASE 


OOBBH 


0056H 


SYM 


FIRSTRENAMEBLOCK 



OOBBH 


01AAH 


SIM 


SIGNONMSG 


0020H 


0174H 


SYM 


PRINTNAME 


0020H 


01A3H 


SIM 


INITIALIZEINPUT 


0020H 


01A8H 


SYM 


OPENFBLOCKFILE 


0O20H 


01F6H 


SIM 


CLOSEFBLOCKFILE 


0020H 


O0F7H 


LIN 


7 


0O20H 


OOFAH 


LIN 


10 


0020H 


OOFEH 


LIN 


11 


0020H 


0101H 


LIN 


14 


0020H 


0105H 


LIN 


73 


0O20H 


0108H 


LIN 


75 


0020H 


010FH 


LIN 


76 


0O20H 


0116H 


LIN 


77 


0020H 


011DH 


LIN 


78 


0O20H 


0126H 


LIN 


79 


0020H 


012AH 


LIN 


60 


0020H 


012DH 


LIN 


84 


002011 


0136H 


LIN 


85 


0O20h 


013DH 


LIN 


06 


0020H 


0144H 


LIN 


b7 


0O20H 


0151H 


LIN 


6b 


0020h 


015AH 


LIN 


89 


0020H 


Olofch 


LIN 


so 


0020H 


0170H 


LIN 


91 


0020b 


0174H 


LIN 


94 


0020b 


0177H 


LIN 


96 


O020h 


OlbEH 


LIN 


97 


0020H 


0196H 


LIN 


96 


0O20H 


019FH 


LIN 


99 


0020H 


01A3H 


LIN 


100 


0020H 


01A6H 


LIN 


103 


0020H 


01A6H 


LIN 


105 



Figure 5-2. LOC86 Symbol Table 
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LOC86 



The Memory Map 

The memory map supplies useful information about segment placement and address 
assignment. Figure 5-3 shows LOC86's memory map. 

The map consists of three parts: 

• Header 

• Segment map 

• Group map 

The header includes the input module name and the start address. 

The segment map is a table with six columns. From left to right the columns show: 

• the START address of the segment 

• the STOP address of the segment 

• the LENGTH of the segment 

• the ALIGNMENT attribute of the segment 

• the NAME of the segment 

• the CLASS of the segment 

• the OVERLAY of the segment 

A "C" printed between the STOP and LENGTH columns indicates that two 
segments have overlapping memory locations; a warning message is also issued. 

A segment may have any one of the following alignment attributes: 



A 


absolute 


B 
6 
M 


byte 

paragraph 

member of an LTL group 


P 
U 


page 
word 


R 


m-page 



MEMORY HAP OF MODULE ROOT 



MODULE START ADDRESS PARAGRAPH = 0020H OFFSET = 0002H 
SEGMENT MAP 



START 


STOP 


LENGTH 


ALIGN 


NAME 


CLASS 


0O2OOH 


0OBB5H 


09B6H 


W 


CODE 


CODE 


00BB6H 


OOBCBH 


0016H 


W 


CONST 


CONST 


OOBCCH 


01703H 


0B3dH 


U 


DATA 


DATA 


01704B 


1B45H 


04H2H 


to 


STACK 


STACK 


01B50H 


01B50H 


0000H 


G 


??SEG 




01BS0B 


01B50H 


OOOOH 


W 


MEMORY 


MEMORY 


GROUP MAP 










ADDRESS 


GROUP OR 


SEGMENT 


NAME 






00200H 


CGROUP 
CODE 










00BB0H 


DGROUP 
CONST 
DATA 
STACK 
MEMORY 











Figure 5-3. LOC86 Memory Map 
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In-page alignment means that the entire segment must be resident within a single 
256-byte page. The address of the first byte in any page has zeros in the first two 
hexadecimal digits ( 00H, 100H, 200H,... OFFFOOH). 

The group map has two columns: the first is the physical address (five-digit hexa- 
decimal number) of the beginning of the group; the second column is the group 
name, followed by the segments contained in that group. The segment names con- 
tained within a given group are listed in the same column but indented slightly. 



Error and Warning Messages 

The error and warning messages are listed consecutively as the error situations are 
encountered. 

See the discussion of the interpretation of individual messages in Appendix F. 



LOC86's Algorithm for Locating Segments 

Assuming that there are no errors in the invocation line or input module, LOC86 
locates an input module in three stages. 

1 . All absolute segments are removed from the list of segments contained in the 
module. 

2. The remaining relocatable segments are ordered into a sequential list. 

3. The relocatable segments are then given absolute addresses according to each 
segment's alignment, size, and memory attribute. 



Absolute Segments 

When LOC86 encounters an absolute segment, LOC86 removes the segment from a 
list of input segments and reserves the memory area used by that segment. LOC86 
maintains a map of free memory. Each time an absolute segment is encountered, the 
memory space used by that segment is removed from the memory map. A segment 
can become absolute in one of three ways: 

1 . It may be assigned an absolute address by the translator. 

2. It may be explicitly specified in an ADDRESSES control. 

3. It may become absolute implicitly. If an absolute segment is specified in an 
ORDER control, then all other segments referred to in that control, either by 
segment name or by class name, are treated as absolute. 



Segment Ordering 

After all memory used by absolute segments has been removed from LOC86's free 
memory map and before LOC86 begins assigning addresses to the remaining 
relocatable segments, LOC86 prepares an ordered list of all relocatable segments. 

All relocatable segments specified in an ORDER control are placed at the head of 
the list. 
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After all ORDER controls, if any, have been processed, LOC86 adds the relocatable 
segments that remain to the end of the list. If the first segment not previously used 
has a class name, then all other segments with the same class name are added to the 
list. After all segments of the class have been added to the list, then the next segment 
is added to the list. 

This process continues until all segments have been added to the ordered list. 



NOTE 

Memory segments do not adhere to this process — a memory segment is 
always located at the top of memory, if possible. If an input module con- 
tains more than one memory segment, only the first is placed at the top of 
memory; the other segments are treated as any other relocatable segment. 



Assigning Addresses to Relocatable Segments 

Once LOC86 completes the ordered list of relocatable segments, it begins assigning 
addresses. LOC86 will never assign addresses that conflict with the location of 
absolute segments or the RESERVE control or between 00H and 200H, since that 
area is reserved for interrupt routines. 

Starting at location 200H, LOC86 scans free memory to find an area in which the 
first segment will fit. When LOC86 finds a suitable address, it assigns it to the seg- 
ment and removes that area from free memory. LOC86 then scans free memory for 
an area that will fit the next segment in the ordered list. LOC86 begins scanning at 
the end of the previous segment. 

IF LOC86 reaches the end of memory and all of the relocatable modules have not 
been located, it makes an additional scan through free memory. The scanning pro- 
cess continues until all modules have been located. 



LOC86's Algorithm for Locating Modules 
Containing Overlays 

LOC86 locates programs with overlays in much the same way as it handles programs 
that do not contain overlays. However, there are some differences. 

1 . Segments contained in the root and each overlay are ordered separately. 

2. Segments that are common to both the root and overlays (e.g., STACK and 
MEMORY) are put at the end of the list of relocatable segments. 

3 . Segments in the root are located at the lowest available addresses in memory. 

4. Segments contained in the overlays are located at the first available address 
above the root. 

5. Segments common to the root and overlays are located immediately above the 
largest overlay in the file. 

Figure 5-4 illustrates how LOC86 treats two PL/M-86 programs that use overlays. 
Figure 5-4a shows how segments are located when the modules are compiled with' the 
LARGE model. Figure 5 -4b shows how segments are located when the modules are 
compiled with the SMALL model of segmentation. 
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ROOT 



OVERLAY 1 



OVERLAY 2 




CLASS DATA 



a. LARGE Model 



Figure 5-4. LOC86's Address Assignments for Overlays 121616-7 
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LOC86 



ROOT 



CODE 



OVERLAY 1 




OVERLAY 2 



CODE 



} 



C GROUP 



CONST 




CONST 




CONST 


DATA 


DATA 


DATA 


STACK 


STACK 


MEMORY 


STACK 


MEMORY 








MEMORY 




























CS- 


' 


' ' 


' ' 


' 







DS,SS *• 



SP- 



II 



CODE FOR ROOT 



CODE FOR 
OVERLAY 1 



CODE FOR 
OVERLAY 2 



CONST FOR ROOT 



DATA FOR ROOT 



CONST FOR OVERLAY 1 



DATA FOR 
OVERLAY 1 



CONST FOR OVERLAY 2 



DATA FOR OVERLAY 2 



W 




STACK 



MEMORY 



SIZE OF ROOT STACK 



MAXIMUM SIZE 
OVERLAY STACK 



MAXIMUM SIZE 
OF MEMORY (OVERLAY 1) 



y D GROUP 



C GROUP 



y D GROUP 



b. SMALL Model 



Figure 5-4. LOC86's Assignments for Overlays (Cont'd.) 121616-8 
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CHAPTER 6 
OH86 



OH86 converts 8086 absolute object modules to 8086 hexadecimal format. The 
input module must be in absolute format, and it may not contain overlays or register 
initialization records. 

Figure 6-1 illustrates the object-to-hexadecimal conversion process. Any errors 
encountered during execution are displayed at the console output device. 

For definition of file-naming conventions and syntax notation, refer to Notational 
Conventions following the Preface. For information on error and warning messages 
which may be produced, refer to Appendix H. 

The general syntax for the invocation line is: 

[directory-name]0HS6 inputfile[JO outputfile] 

The input file contains an 8086 absolute object module. 

TO output file designates the file to receive the 8086 hexadecimal format. If output 
file is not specified, then output is directed to a file that has the same pathname as 
the input list, but its extension is HEX. 

At the end of this document you will find operating system-specific examples of the 
OH86 invocation. 



ABSOLUTE 
OBJECT 
MODULE 



OH86 



J 



ABSOLUTE 

HEX 

FILE 

".HEX" 



CONSOLE 
MESSAGES 



Figure 6-1 . OH86 Input and Output Files 
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APPENDIX A 
iAPX 86,88 ABSOLUTE OBJECT 

FILE FORMATS 



Introduction 

The 8086 Absolute Object File Format herein described is a proper subset of the full 
8086 Object File Formats. An absolute object file consists of a sequence of records 
defining a single absolute module. An absolute module is defined as a collection of 
absolute object information that is specified by a sequence of object records. 



Definitions 

This section defines certain terms fundamental to 8086 Relocation and Linkage 
(R&L). The terms are ordered not alphabetically, but so you can read forward 
without forward references. 



Definition of Terms 

OMF — acronym for Object Module Formats 

R&L — acronym for Relocation and Linkage 

MAS — acronym for Memory Address Space. The 8086 MAS is one megabyte 
(1,048,576 bytes). Note that the MAS should be distinguished from actual memory, 
which may occupy only a portion of the MAS. 

MODULE — an "inseparable" collection of object code and other information pro- 
duced by a translator or by the LINK86 program. When a distinction must be made: 

T-MODULE — denotes a module created by a translator, such as PL/M-86 or 
ASM86, and 

L-MODULE— denotes a module created by LINK86 from one or more constituent 
modules. (Note that modules are not "created" in this sense by the iAPX86,88 
Locater, LOC86; the output module from LOC86 is merely a transformation of the 
input module). 

Two observations about modules must be made: 

1 . Every module must have a name, so that the iAPX86,88 Librarian, LIB86, has a 
handle for the module for display to the user. (If there is no need to provide a 
handle for LIB86, the name may be null.) Translators provide names for T- 
modules, providing a default name (possibly the file name or a null name) if 
neither source code nor user specifies otherwise. 

2. Every T-module in a collection of modules linked together may have a different 
name, so that symbolic debugging systems can distinguish the various symbols. 
This restriction is not required by R&L and is not enforced by it. 

FRAME — a contiguous region of 64K of MAS, beginning on a paragraph boundary 
(i.e., on a multiple of 16 bytes). This concept is useful because the content of the 
four 8086 segment registers define four (possibly overlapping) FRAME'S; no 16-bit 
address in the 8086 code can access a memory location outside of the current four 
FRAME'S. The FRAME starting at address 0000H is FRAME 0. 
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Module Identification 



In order to determine that a file contains an object program, a module header record 
will always be the first record in a module. There are two kinds of header records 
and each provides a module name. The additional functions of the header records 
are explained below. 

A module name may be generated during one of two processes: translation or link- 
ing. A module that results from translation is called a T-MODULE. A T-MODULE 
will have a T-MODULE HEADER RECORD (THEADR). A name may be 
provided in the THEADR record by a translator. This name is then used to identify 
the progenitor of all debug information found in the T-MODULE. The name may 
be null, i.e., of length zero. 

A module that results from linking and locating is called an L-MODULE. An 
L-MODULE will always have an L-MODULE HEADER RECORD (LHEADR) or 
an R-MODULE HEADER RECORD (RHEADR). In the LHEADR or RHEADER 
record a name is also provided. This name is available for use to refer to the module 
without using any of its constituent T-MODULE names. An example would be two 
T-MODULES, A and B, linked together to form L-MODULE C. L- MODULE C 
will contain two THEADR records and will begin with an LHEADR record with the 
name C provided by the linker as a directive from the user. The L- MODULE C can 
be referred to by other tools such as the library manager without having to know 
about the originating module's names, yet the originating module's names are 
preserved for debugging purposes. 



Module Attributes 



In addition to a name, a module may have the attribute of being a main program as 
well as having a specified starting address. 

If a module is not a main module yet has a starting address, then this value has been 
provided by a translator, possibly for debugging purposes. A starting address 
specified for a non-main module could be the entry point of a procedure, which may 
be loaded and initiated independent of a main program. 



Physical Segment Definition 



A module is defined as a collection of data bytes defined by a sequence of records 
produced by a translator. The data bytes represent contiguous regions of memory 
whose contents are determined at translation time. 



Physical Segment Addressability 

The 8086 addressing mechanism provides segment base registers from which a 64K 
byte region of memory, called a Frame, may be addressed. There is one code seg- 
ment base register (CS), two data segment base registers (DS, ES), and one stack seg- 
ment base register (SS). 
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Data 

The data that defines the memory image represented by a module is maintained in 
two varieties of DATA records: PHYSICAL ENUMERATED DATA RECORD 
(PEDATA) and PHYSICAL ITERATED DATA RECORD (PIDATA). Both 
records specify the data to be loaded into a contiguous section of memory. The start 
address of this contiguous section is given in the record. PEDATA records contain 
an exact byte-by-byte copy of the desired memory image. The PIDATA record dif- 
fers in that the data bytes are represented within a structure that must be expanded 
by the loader. The purpose of the PIDATA record is to reduce module size by 
encoding repeated data rather than explicitly enumerating each byte, as the 
PEDATA record does. 



Record Syntax 

The following syntax shows the valid orderings of records to form an absolute 
module. In addition, the given semantic rules provide information about how to 
interpret the record sequence. The syntactic description language used herein is 
defined in Wirth: CACM, November 1977, V20, N 11, pg. 822-823. 

absolute_object_file =module. 

module =tmod I Imod I omod. 

tmod =THEADR [REGINT]content_def mod_tail. 

Imod =LHEADR [REGINT]t_component mod_tail. 

omod =RHEADR {OVLDEF} [REGINT] o_component 

{OVLDEF} mod_tail. 

o_component =t_component ENDREC. 

t_component =[THEADR] content_def 

content_def =PEDATA \ PIDATA. 

mod_tail =[REGINT] MODEND. 



NOTE 

The character strings represented by capital letters above are not literals but 
are identifiers that are further defined in the section defining the Record 
Formats. 

One module may not contain more than one REGINT record and more than one 
OVLDEF sequence. If a REGINT record and an OVLDEF sequence exist, the 
REGINT record must immediately follow the OVLDEF sequence. 

A proper Absolute Object File produced by Intel products will contain at least the 
above record types. It may also contain other record types which, if present, will 
follow the Module Header record and precede the Module End record. These other 
record types fall into two categories: 

1. Extraneous, containing information not pertinent to an absolute loader. The 
record numbers in this category are: 

72H, 74H, 7AH, 7CH, 7EH, 88H, 8CH, 8EH, 90H, 92H, 94H, 96H, 98H, 9AH, 9CH 

2. Erroneous, containing information about relocation, indicating that the object 
module is not yet in absolute form or that erroneous record types exist. The 
record numbers in this category are all other record type numbers. 
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Record Formats 



The following pages present diagrams of Record Formats in schematic form. Here is 
a sample, to illustrate the various conventions: 



Sample Record Format (SAMREC) 



REC 


RECORD 


NAME 


CHK 


TYP 


LENGTH 




SUM 


xxH 









I — mt — I 



rpt 



Title and Official Abbreviation 

At the top is the name of the Record Format described, together with an official 
abbreviation. To promote uniformity among various programs, the abbreviation 
should be used in both code and documentation. The abbreviation is always six 
letters. 



The Boxes 

Each format is drawn with boxes of two sizes. The narrow boxes represent single 
bytes. The wide boxes represent two bytes (or one word) each. In the object file, the 
low order byte of a word value comes first. The wide boxes with four vertical bars in 
the top and bottom represent 4-byte fields. The wide boxes with three dots in the top 
and bottom represent a variable number of bytes, one or more, depending upon 
content. 



Rec Typ 

The first byte in each record contains a value between and 255, indicating the type 
of record. 



Record Length 

The second field in each record contains the number of bytes in the record, exclusive 
of the first two fields. 



Name 

Any field that indicates a "NAME" has the following internal structure: the first 
byte contains a number between and 40, inclusive, that indicates the number of 
remaining bytes in the field. The remaining bytes are interpreted as a byte string; 
each byte must represent the ASCII code of a character drawn from this set: 

[?@ :._0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ ] 

Most translators will choose to constrain the character set more strictly; the above 
set has been chosen to "cover" that required by all current processors. 
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Repeated Fields 

Some portions of a Record Format contain a field or series of fields that may occur 
an indefinite number of times (zero or more). Such fields are indicated by the 
"repeated" or "rpt" brackets below the boxes. 

Similarly, some portions of the Record Format are present only if some given condi- 
tion obtains; these fields are indicated by similar "conditional" brackets below the 
boxes. 



ChkSum 

The last field in each record is a check sum, which contains the two's complement of 
the sum (modulo 256) of all other bytes in the record. Therefore, the sum (modulo 
256) of all bytes in the record equals 0. 



Bit Fields 

Descriptions of contents of fields will sometimes get down to the bit level. Boxes 
with vertical lines drawn through them represent bytes or words; the vertical lines in- 
dicate bit boundaries; thus this byte has three bit-fields of three, one, and 
four bits: 



1 1 
1 1 




1 1 1 
1 1 1 



Ignored Records 



REC 
TYP 



RECORD 
LENGTH 



IGNORE 
THIS 
PART 



CHK 
SUM 



All record types that may be in an object module that provide information not perti- 
nent to an absolute loader must be ignored. They may all be treated as if they have 
the above format. Records in this category have REC TYP in the set 72H, 74H, 
7AH, 7CH, 7EH, 88H, 8CH, 8EH, 90H, 92H, 94H, 96H, 98H, 9AH, 9CH. 



T-Module Header Record (THEADR) 



REC 


RECORD 


T 


CHK 


TYP 


LENGTH 


MODULE 


SUM 


80H 




NAME 





Every module output from a translator must have a T-MODULE HEADER 
RECORD. Its purpose is to provide the identity of the original defining module for 
all debug information encountered in the module up to the following T-MODULE 
HEADER RECORD or MODULE END RECORD. 

This record can also serve as the header for a module; i.e., it can be the first record 
and will be for modules that are output from translators. 
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T-Module Name 

The T-MODULE NAME provides a name for the T-MODULE. 

L-Module Header Record (LHEADR) 



REC 


RECORD 


L 


CHK 


TYP 


LENGTH 


MODULE 


SUM 


82H 




NAME 





A module created by LINK86 and LOC86 may have an L-MODULE HEADER 
RECORD. This record serves only to identify a module that has been processed 
(output) by LINK86 and/or LOC86. When several modules are linked to form 
another module, the new module requires a name, perhaps unique from those of the 
linked modules, by which it can be referred to (by the LIB86 program, for example). 



L-Module Name 

The L-MODULE NAME provides a name for the L-Module. 

R-MODULE HEADER RECORD (RHEADR) 



REC 


RECORD 


R-MODULE 


OVERLAY 


CHK 


TYP 


LENGTH 


NAME 


INFO 


SUM 


6EH 











Every module with overlays created by LINK86/LOC86 will have an R-MODULE 
HEADER RECORD. This record serves to identify a module that has been pro- 
cessed (output) by LINK86/LOC86. It also specifies the overlay count and the loca- 
tion of the Overlay Definition records. When several modules are linked to form 
another module, the new module requires a name, perhaps unique from those of the 
linked modules, by which it can be referred to. 



R-MODULE NAME 

The R-MODULE NAME provides a name for the R-Module. 



OVERLAY INFO 

The OVERLAY INFO field provides information on overlays in the module and has 
the following format: 



IGNORE 
THIS 
PART 



OVERLAY 
RECORD 
COUNT 



OVERLAY 
RECORD 
OFFSET 



IGNORE 
THIS 
PART 



The first subfield is a 5 -byte field that should be ignored. 
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The OVERLAY RECORD COUNT subfield indicates the number of Overlay 
Definition Records in the module. 

The OVERLAY RECORD OFFSET subfield is a 4-byte field. It contains a 32-byte 
unsigned number indicating the location in bytes, relative to the start of the object 
file, of the first Overlay Definition Record in the Module. 

The last subfield is a 16-byte field that should be ignored. 



OVERLAY DEFINITION RECORD (OVLDEF) 



REC 
TYP 
76H 



RECORD 
LENGTH 



OVERLAY 
NAME 



OVERLAY 
LOCATION 




This Record provides the overlay name, the location of the overlay in the object file. 

A loader may use this record to locate the data records of the overlay in the object 
file. 



OVERLAY NAME 

The OVERLAY NAME field provides a name by which a collection of data records 
may be referenced for loading. 



OVERLAY LOCATION 

The OVERLAY LOCATION is a 4-byte field which gives the location in bytes 
relative to the start of the file of the first byte of the records in the overlay. 



The Z field is a reserved field. This field is required to be zero. 



END RECORD (ENDREC) 



REC 


RECORD 


END 


CHK 


TYP 


LENGTH 


TYP 


SUM 


78H 









This record is used to denote the end of a set of records such as records in an 
overlay. 
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ENDTYP 

This field specifies the type of the set. It has the following format: 





















TYP 

r 



TYP is a two bit subfield that specifies the following types of ends: 



TYP 



TYPE OF END 



End of overlay 

(Reserved) 

(Illegal) 

(Illegal) 



REGISTER INITIALIZATION RECORD (REGINT) 



REC 
TYP 
70H 



RECORD 
LENGTH 



REG 
TYP 



REGISTER 
CONTENTS 



CHK 
SUM 



repeated ■ 



This record provides information about the 8086 registers/register-pairs: CS and 
IP, SS and SP, DS and ES. The purpose of this information is for a loader to set the 
necessary registers for initiation of execution. 



REG TYP 

The REG TYP field provides the register/register-pair name. It has the following 
format: 



REGID 





















REGID is a two bit subfield that specifies the name of the registers/register-pairs as 
follows: 



REGID 



REGISTER/REGISTERPAIR 






CSandIP 


1 


SS and SP 


2 


DS 


3 


ES 
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REGISTER CONTENTS 

The REGISTER CONTENTS field has the following format: 



FRAME 
NUMBER 



REGISTER 
OFFSET 



— conditional — 

The Z fields are reserved fields. They are required to be zero. 

The FRAME NUMBER field specifies a frame number that must be used to 
initialize the base register indicated by the REGID value. 

The REGISTER OFFSET field, present only if REGID <= 1, specifies an offset 
relative to the FRAME. This value is appropriate for the initialization of either the 
IP register (REGID = 0) or the SP register (REGID = 1). 



Module End Record (MODEND) 



REC 
TYP 
8AH 



RECORD 
LENGTH 



MOD 
TYP 



START 
ADDRS 



L_ 



conditional 




This record serves two purposes. It denotes the end of a module and indicates 
whether the module just terminated has a specified entry point for initiation of 
execution. If the latter is true, then the execution address is specified. 



Mod Typ 

This field specifies the attributes of the module. The bit allocation and their 
associated meanings are as follows: 



1 

MATTR 
1 





















MATTR is a two-bit subfield that specifies the following module attributes: 
MATTR MODULE ATTRIBUTE 



Non-main module with no starting address 
Non-main module with starting address 
(invalid value for MATTR) 
Main module with starting address 
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Start Addrs 

The START ADRS field has the following format: 



FRAME 
NUMBER 


OFFSET 



FRAME NUMBER. This field specifies a frame number relative to which the 
module will begin execution. This value is appropriate for insertion into the CS 
register for program initiation. 

OFFSET. This field specifies an offset relative to the FRAME NUMBER that 
defines the exact location of the first byte at which to begin execution. This value is 
appropriate for insertion into the IP register for program initiation. 

Physical Enumerated Data Record (PEDATA) 



REC 
TYP 
84H 


RECORD 
LENGTH 


FRAME 
NUMBER 


OFF 
SET 


DAT 


CHK 
SUM 



L_ 



rpt- 



This record provides contiguous data, from which a portion of an 8086 memory 
image may be constructed. 

Frame Number 

This field specifies a Frame Number relative to which the data bytes will be loaded. 

Offset 

This field specifies an offset relative to the FRAME NUMBER which defines the 
location of the first data byte of the DAT field. Successive data bytes in the DAT 
field occupy successively higher locations of memory. The value of OFFSET is con- 
strained to be in the range to 15 inclusive. If an OFFSET value greater than 15 is 
desired, then an adjustment of the FRAME NUMBER should be done. 

Dat 

This field provides consecutive bytes of an 8086 memory image. The number of 
DAT bytes is constrained only by the RECORD LENGTH field. The address of 
each byte must be within the frame specified by FRAME NUMBER. 

Physical Iterated Data Record (PI DATA) 



REC 
TYP 
86H 



RECORD 
LENGTH 



FRAME 
NUMBER 



OFF 
SET 



ITERATED 
DATA 
BLOCK 






repeated 




This record provides contiguous data, from which a portion of an 8086 memory 
image may be constructed. It allows initialization of data segments and provides a 
mechanism to reduce the size of object modules when there are repeated data to be 
used to initialize a memory image. 
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Frame Number 

This field specifies a frame number relative to which the data bytes will be loaded. 

Offset 

This field specifies an offset relative to the FRAME NUMBER which defines the 
location of the first data byte in the ITERATED DATA BLOCK. Successive data 
bytes in the ITERATED DATA BLOCK occupy successively higher locations of 
memory. The range of OFFSET is constrained to be between and 15 inclusive. If a 
value larger than 15 is desired for OFFSET, then an adjustment of FRAME 
NUMBER should be done. 

Iterated Data Block 

This repeated field is a structure specifying the repeated data bytes. It is a structure 
that has the following format: 



REPEAT 
COUNT 


BLOCK 
COUNT 


CONTENT 



Repeat Count. This field specifies the number of times that the CONTENT portion 
of this ITERATED DATA BLOCK is to be repeated, and must be greater than zero. 

Block Count. This field specifies the number of ITERATED DATA BLOCKS that 
are to be found in the CONTENT portion of this ITERATED DATA BLOCK. If 
this field has value zero then the CONTENT portion of this ITERATED DATA 
BLOCK is interpreted as data bytes. 

If BLOCK COUNT is non-zero then the CONTENT portion of this ITERATED 
DATA BLOCK is interpreted as that number of ITERATED DATA BLOCKS. 

Content. This field may be interpreted in one of two ways, depending on the value 
of the previous BLOCK COUNT field. 

If BLOCK COUNT is zero, then this field is a one-byte count followed by the 
indicated number of data bytes. 

If BLOCK COUNT is non-zero, then this field is interpreted as the first byte of 
another ITERATED DATA BLOCK. 

NOTE 

From the outermost level, the number of nested ITERATED DATA 
BLOCKS is limited to 17;' i.e., the number of levels of recursion is limited 
to 17. 

The address of each data byte must be within the frame specified by 
FRAME NUMBER. 



Hexadecimal Object File Format 

Hexadecimal object file format is a way of representing an object file in ASCII. 

The function of the utility program, 0H86, is to convert 8086 absolute object 
modules to 8086 hexadecimal object modules. 
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The hexadecimal representation of binary is coded in ASCII. For example, the eight- 
bit binary value 0011 1111 is 3F in hexadecimal. To code this ASCII, one eight-bit 
byte containing the ASCII code for 3(00110011 or 33H) and one eight-bit byte con- 
taining the ASCII code for F(0100 0110 or 46H) are required. This representation 
(ASCII hexadecimal) requires twice as many bytes as the binary. 

There are four different types of records that may make up an 8086 hexadecimal 
object file. They are: 

• Extended Address Record 

• Start Address Record 

• Data Record 

• End of File Record 

Each record begins with a RECORD MARK field containing 3 AH, the ASCII code 
for colon (:). 

Each record has a REC LEN field which specifies the number of bytes of informa- 
tion or data which follows the RECTYP field of each record. Note that one byte is 
represented by two ASCII characters. 

Each record ends with a CHECKSUM field that contains the ASCII hexadecimal 
representation of the two's complement of the eight-bit sum of the eight-bit bytes 
that result from converting each pair of ASCII hexadecimal digits to one byte of 
binary, from and including the RECORD LENGTH field to and including the last 
byte of the DATA field. Therefore, the sum of all the ASCII pairs in a record after 
converting to binary, from the RECORD LENGTH field to and including the 
CHECKSUM field, is zero. 



Extended Address Record 



RECD 


REC 




REC 




CHK 


MARK 


LEN 


ZEROES 


TYP 


USBA 


SUM 


' : ' 


'02' 


'0000' 


'02' 







The 8086 EXTENDED ADDRESS RECORD is used to specify bits 4-19 of the Seg- 
ment Base Address (SBA) where bits 0-3 of the SBA are zero. Bits 4-19 of the SBA 
are referred to as the Upper Segment Base Address (USBA). The absolute memory 
address of a content byte in a subsequent DATA RECORD is obtained by adding 
the SBA to an offset calculated by adding the Load Address Field of the containing 
DATA RECORD to the index of the byte in the DATA RECORD (0, 1, 2, ... n). 
The offset addition is done modulo 64K, ignoring a carry, so that offset wrap- 
around loading (from OFFFFH to 00000H) results in wrapping around from the end 
to the beginning of the 64K segment defined by the SBA. The address at which a par- 
ticular data byte is loaded is calculated as: 



SBA + ([DRLA + DRI] MOD 64K) 



where 



DRLA is the DATA RECORD LOAD ADDRESS. 
DRI is the data byte index within a DATA RECORD. 
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When an EXTENDED ADDRESS RECORD defines the value of SBA, the 
EXTENDED ADDRESS RECORD may appear anywhere within an 8086 hexa- 
decimal object file. This value remains in effect until another EXTENDED 
ADDRESS RECORD is encountered. The SBA defaults to zero until an 
EXTENDED ADDRESS RECORD is encountered. 



Reed Mark 

The RECD MARK field contains 03 AH, the hex encoding of ASCII ':'. 

Rec Len 

The Record Length field contains 3032H, the hex encoding of ASCII '02'. 

Zeroes 

The Load Address field contains 30303030H, the hex encoding of ASCII '0000'. 

RecTyp 

The Record Type field contains 3032H, the hex encoding of ASCII '02'. 

USBA 

The USBA field contains four ASCII hexadecimal digits that specify the 8086 USBA 
value. The high-order digit is the 10th character of the record. The low order digit is 
the 13th character of the record. 

Chk Sum 

This is the check sum on the REC LEN, ZEROES, REC TYP, and USBA fields. 

Data Record 



DATA 



The DATA RECORD provides a set of hexadecimal digits that represent the ASCII 
code for data bytes that make up a portion of an 8086 memory image. The method 
for calculating the absolute address for each byte of DATA is described in the 
discussion of the Extended Address Record. 



Reed Mark 

The RECD MARK field contains 03AH, the hex encoding of ASCII ':' . 

Rec Len 

The REC LEN field contains two ASCII hexadecimal digits representing the number 
of data bytes in the record. The high-order digit comes first. The maximum value is 
'FF or4646H (255 decimal). 



RECD 


REC 


LOAD 


REC 




MARK 


LEN 


ADDRESS 


TYP 
'00' 


D 
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Load Address 

The LOAD ADDRESS field contains four ASCII hexadecimal digits representing 
the offset from the SBA (see EXTENDED ADDRESS RECORD) defining the 
address at which byte of the DATA is to be placed. The LOAD ADDRESS value is 
used in calculation of the address of all DATA bytes. 



Rec Typ 

The REC TYP field in a DATA record contains 3030H, the hex encoding of 
ASCII '00'. 



Data 

The DATA field contains a pair of hexadecimal digits that represent the ASCII code 
for each data byte. The high order digit is the first digit of each pair. 



Chk Sum 

This is the check sum on the REC LEN, LOAD ADDRESS, REC TYPE, and 
DATA fields. 



Start Address Record 



RECD 


REC 




REC 






CHK 


MARK 


LEN 
'04' 


ZEROES 
'0000' 


TYP 
'03' 


CS 


IP 


SUM 



The START ADDRESS RECORD is used to specify the execution start address for 
the object file. Values are given for both the Instruction Pointer (IP) and Code Seg- 
ment (CS) registers. This record can appear anywhere in a hexadecimal object file. 

If a START ADDRESS RECORD is not present in an 8086 hexadecimal file, a 
loader is free to assign a default start address. 



Reed Mark 

The RECD MARK field contains 03 AH, the hex encoding for ASCII ':'. 

Rec Len 

The REC LEN field contains 3034H, the hex encoding for ASCII '04'. 

Zeroes 

The ZEROES field contains 30303030H, the hex encoding for ASCII '0000'. 

Rec Typ 

The REC TYP field contains 3033H, the hex encoding for ASCII '03'. 
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cs 

The CS field contains four ASCII hexadecimal digits that specify the 8086 CS value. 
The high-order digit is the 10th character of the record; the low-order digit is the 
13th character of the record. 



IP 

The IP field contains the four ASCII hexadecimal digits that specify the 8086 IP 
value. The high-order digit is the 14th character of the record, the low order digit is 
the 17th character of the record. 



Chk Sum 

This is the check sum on the REC LEN, ZEROES, REC TYP, CS, and IP fields. 



End of File Record 



RECD 


REC 




REC 


CHK 


MARK 


LEN 


ZEROES 


TYP 


SUM 


' : ' 


'00' 


'0000' 


'01' 


«FP 



The END OF FILE RECORD specifies the end of the hexadecimal object file. 

Reed Mark 

The RECD MARK field contains 03AH, the ASCII code for colon (:). 

Rec Len 

The REC LEN field contains two ASCII zeroes (3030H). 

Zeroes 

The ZEROES field contains four ASCII zeroes (30303030H). 

Rec Typ 

The REC TYP field contains 3031 H, the ASCII code for 01 H. 

Chk Sum 

The CHK SUM field contains 4646H, the ASCII code for FFH, which is the check 
sum on the REC LEN, ZEROES and REC TYP fields. 
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Examples 

Sample Absolute Object File 

The following is an example of an absolute object file. The file contains eight 
records. The eight records perform the following functions: 

Record Function 

1 LHEADR record begins the object module and defines the module 
name. 

2 THEADR record defines the translator-generated module name 
which is the same as the name in the LHEADR record. 

3 PEDATA record defines a contiguous memory image from 00200H 
to 0021 5H. 

4 PEDATA record defines a contiguous memory image from 00360H 
to00377H. 

5 PEDATA record defines a contiguous memory image from 004 15H 
to0042BH. 

6 PEDATA record defines a contiguous memory image from 
051620Hto051633H. 

7 P ID AT A record defines a contiguous memory image from 
051 BOOH to 051B1DH. The iterated data consists of three repeti- 
tions of "ABC" (414243H), followed by three repetitions of (four 
repetitions of "D" (44H)), three repetitions of "E" (45H). 

8 MODEND record specifies that the module should be started with 
CS = 5162H and IP = 0005H. 

(1) 82 0008 06534 14D504C45 AE 

(2) 80 0008 0653414D504C45 B0 

(3) 84 001 A 0020 00 
004992DB246DB6FF489 1 D A236CB5FE47 
90D9226BB4FD 63 

(4) 84 001 C 0036 00 
0062C42688EA4CAE1072D43698FA5CBE 
2082E446A80A6CCE 82 

(5) 84 001 B 0041 05 
001D3A577491AECBE805223F5C7996B3 
D0ED0A2744617E 72 

(6) 84 0018 5162 00 
00850A8F14991EA328AD32B73CC146CB 
50D55ADF FB 

(7) 86 001C 51B0 00 
0003 0000 03 414243 

0003 0002 

0004 0000 01 44 
0003 0000 01 45 FA 

(8) 8 A 0006 CO 5162 0005 F8 

NOTE 

The blank characters and carriage return and line feed characters are 
inserted here to improve readability. They do not occur in an object 
module. This file has been converted to ASCII hex so that it may be printed 
here. All word values (RECORD LENGTH, REPEAT COUNT, etc.) have 
been byte-reversed to improve readability. 
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Sample Absolute Hexadecimal Object File 

The following is the hexadecimal object file representation of the object file given in 
the example above: 



020000020020DC 

10000000004992DB246DB6FF489 1 DA236CB5FE47B8 

0600100090D9226BB4FD43 

020000020036C6 

100000000062C42688EA4CAE1072D43698FA5CBE00 

080010002082E446A80A6CCE30 

02000002004 IBB 

10000500001D3A577491AECBE805223F5C7996B353 

0700 1 500D0ED0 A27446 1 7ED3 

02000002516249 

1000000000850A8F14991EA328AD32B73CC146CB98 

0400100050D55ADF8E 

020000025 1B0FB 

1000000041424341424341424344444444454545BF 

040000035162000541 
00000001FF 
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HEXADECIMAL-DECIMAL CONVERSION 



The following table is for hexadecimal-to-decimal and decimal-to-hexadecimal con- 
version. To find the decimal equivalent of a hexadecimal number, locate the hexa- 
decimal number in the correct position and note the decimal equivalent. Add the 
decimal numbers. 

To find the hexadecimal equivalent of a decimal number, locate the next lower 
decimal number in the table and note the hexadecimal number and its position. Sub- 
tract the decimal number from the table from the starting number. Find the dif- 
ference in the table. Continue this process until there is no difference. 



BYTE 


BYTE 


BYTE 


HEX 


DEC 


HEX 


DEC 


HEX 


DEC 


HEX 


DEC 


HEX DEC 


HEX DEC 






































1 


1,048,576 


1 


65,536 


1 


4,096 


1 


256 


1 


16 


1 


1 


2 


2,097,152 


2 


131,072 


2 


8,192 


2 


512 


2 


32 


2 


2 


3 


3,145,728 


3 


196,608 


3 


12,288 


3 


768 


3 


48 


3 


3 


4 


4,194,304 


4 


262,144 


4 


16,384 


4 


1,024 


4 


64 


4 


4 


5 


5,242,880 


5 


327,680 


5 


20,480 


5 


1,280 


5 


80 


5 


5 


6 


6,291,456 


6 


393,216 


6 


24,576 


6 


1,536 


6 


96 


6 


6 


7 


7,340,032 


7 


458,752 


7 


28,672 


7 


1,792 


7 


112 


7 


7 


8 


8,388,608 


8 


524,288 


8 


32,768 


8 


2,048 


8 


128 


8 


8 


9 


9,437,184 


9 


589,824 


9 


36,864 


9 


2,304 


9 


144 


9 


9 


A 


10,485,760 


A 


655,360 


A 


40,960 


A 


2,560 


A 


160 


A 


10 


B 


11,534,336 


B 


720,896 


B 


45,056 


B 


2,816 


B 


176 


B 


11 


C 


12,582,912 


C 


786,432 


C 


49,152 


C 


3,072 


C 


192 


C 


12 


D 


13,631,488 


D 


851 ,968 


D 


53,248 


D 


3,328 


D 


208 


D 


13 


E 


14,680,064 


E 


917,504 


E 


57,344 


E 


3,584 


E 


224 


E 


14 


F 


15,728,640 


F 


983,040 


F 


61,440 


F 


3,840 


F 


240 


F 


15 
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APPENDIX C 

THE EFFECT OF AVAILABLE MEMORY 

ON LINK86, CREF86, LIB86, AND LOC86 



The system resources required by LINK86, CREF86, LIB86, or LOC86 depend on 
the number of symbols, modules, or segments in the input file(s). The greater the 
number of symbols in the input, the greater the memory requirements. 

LINK86, CREF86, AND LIB86 

These utilities can take advantage of up to 512K of available memory space. When 
the number of symbols in the input list requires more memory than is available, 
these utilities use disk resources to accommodate the remainder. Available memory 
means RAM which the utilities have available to them exclusively. Once a utility has 
run out of memory and has to use disk, performance will become impaired. 

The following table defines the number of symbols or modules which these utilities 
may process without performance degradation, given several levels of available 
memory. The available memory depends on the hardware and software environment 
under which the utilities are running on your system. Note that the relationship 
between number of symbols or modules and the amount of available memory is 
linear, up to a maximum. The following assumptions were used to calculate the 
figures provided: 

• Variable and module names average 10 characters. 

• Each symbol has five references (CREF86). 

• Each module has 1 .4 public names (LIB86). 

• A symbol as used here is an abstract representation of an 8086 object module 
format record: 



Maximum number of symbols or 
modules which can be processed 
without performance penalty: 

With 100K available memory 
With 164K available memory 
With 228K available memory 
With 484K available memory 

Theoretical maximum number of 
symbols or modules, regardless of 
available memory: 



LINK86 



1 ,700 symbols 

2,900 symbols 

4,200 symbols 

10,000 symbols 



CREF86 



1 ,900 symbols 

3,300 symbols 

4,700 symbols 

11,000 symbols 



LIB66 



450 modules 
1,000 modules 
1,700 modules 
4,000 modules 



10,000 symbols 11,000 symbols 4,000 symbols 



L0C86 

With 96K of available memory, LOC86 will support up to 900 segments. 
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APPENDIX D 

LINK86 CONTROLS 

AND ERROR MESSAGES 



Table D-l lists all of LINK86's control syntax, abbreviations, and default settings. 
Table D--1. Summary of LINK86 Controls 



Control 


Abbrev. 


Default 


ASSIGN( { variabletitddress) >[,...]> 


AS 


Not applicable 


ASSUMEROOT(patf»na/ne) 


AR 


Not applicable 


BIND 


Bl 


NOBIND 


NOBIND 


NOBI 


COMMENTS 


CM 


COMMENTS 


NOCOMMENTS 


NOCM 


FASTLOAD 


FL 


NOFASTLOAD 


NOFASTLOAD 


NOFL 


INITCODE 


IC 


Not applicable 


LINES 


LI 


LINES 


NOLINES 


NOLI 


MAP 


MA 


MAP 


NOMAP 


NOMA 


MEMPOOL(min-size[,maxsize]) 


MP 


Not applicable 


NAM E{module name) 


NA 


Not applicable 


OBJECTCONTROLS( 

{LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS [EXCEPT(sym6o/ [,...])] | 
NOPUBLICS [EXCEPT(sy/n6o/ [,...])] | 
TYPE | NOTYPE | 
PURGE | NOPURGE} [,...]) 


OC 


Not applicable 


ORDER( igroup{<.segment[\class[\ overlay ]]> 


OD 


Not applicable 


OVERLAY[(over/ay)] 


OV 


NOOVERLAY 


NOOVERLAY 


NOOV 


PRINT[(paf/mame>] 


PR 


PRINT(ofy'ec//y/e.MP1) 


NOPRINT 


NOPR 


PRINTCONTROLS( 

{LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS [EXCEPT(sym6o/ [,...])] | 
NOPUBLICS [EXCEPT(sy/n/>o/ [,...])] | 
TYPE | NOTYPE | 
PURGE | NOPURGE> [,...]) 


PC 


Not applicable 
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Table D-l . Summary of LINK86 Controls (Cont'd.) 



Control 


Abbrev. 


Default 


PUBLICS [EXCEPT(sym6o/ [,...])] 


PL [EC] 


PUBLICS 


NOPUBLICS [EXCEPJisymbol [,...])] 


NOPL [EC] 


PUBLICSONLY(patfma/ne[,...]) 


PO 


Not applicable 


PURGE 


PU 


NOPURGE 
NOPURGE 


NOPURGE 


NOPU 


RENAMEGROUPSKfifrot/p lOgroup} [,...]) 


RG 


Not applicable 


SEGSIZE( 

i segment[ \class [ \overlay]] 
(min-size[, [max- size])) > 


SS 


Not applicable 


SYMBOLS 


SB 


SYMBOLS 


NOSYMBOLS 


NOSB 


SYMBOLCOLUMNS(<1 | 2 1 3| 4>) 


SC 


SYMBOLCOLUMNS(2) 


TYPE 


TY 


TYPE 


NOTYPE 


NOTY 



The following are descriptions of all LINK86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning — how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect — the state of LINK86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 



Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the 
resulting code is valid. 



Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 



ERROR 1 : I/O ERROR 

operating system error message 
FILE: pathname 



ERROR 2: I/O ERROR 

operating system error message 
FILE: pathname 
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ERROR 3: I/O ERROR 

operating system error message 
FILE: pathname 



ERROR 4: CONSOLE I/O ERROR 
operating system error message 
FILE: pathname 

Meaning 

An I/O error was detected by the operating system. The error number identifies the 
file that caused the error: 

1 . The input file 

2. The print file 

3. The object file 

4. The console file (usually the console) 

Refer to the documentation for your operating system for a complete list of all 
possible messages. 

Effect 

LINK 86 immediately terminates processing, all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the error and restart LINK86 . 



ERROR 5: INPUT PHASE ERROR 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86 encountered a record during the second phase of linkage that does not agree 
with information gathered during the first phase of linkage. 

Cause 

This error is caused by a data transmission error or a LINK86 error. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

,User Action 

Contact Intel immediately. Forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 
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ERROR 6: CHECK SUM ERROR 
FILE: pathname 
MODULE: module name 

Meaning 

The check sum field at the end of one of the object module records indicates a 
transcription error. 

Cause 

Any one of many possible data encoding or communication errors could be at fault. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Retranslate the source that produced the specified module and relink. 



ERROR 7: COMMAND INPUT ERROR 

Meaning 

LINK86 encountered an error while attempting to read the complete invocation line. 

Cause 

Possibly an end-of-f iie while reading from the console input device. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Examine the invocation line, and reinvoke LINK86 correctly. 
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WARNING 8: SEGMENT COMBINATION ERROR 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 
CLASS: class name 

Meaning 

Two segments with the same name have been found to be uncombinable. 

Cause 

The specified segments have different combination attributes or incompatible align- 
ment attributes. 

Effect 

Although LINK86 will continue processing pass 1, pass 2 will not be started. The 
object file will be useless and the print file will contain limited information. 

User Action 

Retranslate the source that produced the specified file and module. 



WARNING 9: TYPE MISMATCH 
FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 

Meaning 

LINK86 has found a public/external symbol pair for which the type definitions do 
not agree. 

Effect 

LINK86 continues processing using the first definition only. The object file and the 
print file should be valid, except the second definition is ignored. 

User Action 

Modify the public or external declaration and recompile and relink the source file. 
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WARNING 10: DIFFERENT VALUES FOR 
FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 

Meaning 

LINK86 encountered the same symbol declared public in two different modules. The 
specified file and module contains the second definition encountered. 

Cause 

Two modules have used the same symbol name for different public definitions. 

Effect 

L IN K86 continues processing using the value of the first public definition; the 
second definition is ignored. Both the print file and the object file will be valid. 

User Action 

Change the name of the symbol in either the specified file or the file containing the 
earlier definition. 



ERROR 11: INSUFFICIENT MEMORY 
FILE: pathname 
MODULE: module name 

Meaning 

There is insufficient memory in your system for LINK86 to build its internal tables 
and data structures. 

Cause 

You are using too many public symbols. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

If expanding system memory is not possible, try incremental linkage (i.e., link 
smaller sets of files together using the NOPUBLICS control, then link the resulting 
composite modules together). 
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WARNING 12: UNRESOLVED SYMBOLS 
FILE: pathname 
MODULE: module name 

Meaning 

There are declarations of external symbols that were not resolved during this 
linkage. 

Cause 

This is very common when performing an incremental linkage. 

Effect 

The print file is valid. The object file must be linked to resolve the external 
references. 

User Action 

Link object file to a file that will resolve the external references. 



WARNING 13: IMPROPER FIXUP 
FILE: pathname 
MODULE: module name 

Cause 

The external reference makes assumptions about the segment register that do not 
agree with the assumption made for the public definition. 

Effect 

LIN^86 continues processing. The object file will not be usable, but the print file 
will be complete and accurate. 

User Action 

Depending on the cause of the error: change your ORDER control, recompile with a 
different model of segmentation, or change the source and reassemble. 
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WARNING 14: GROUP ENLARGED 
FILE: pathname 
GROUP: group name 
NODULE: module name 

Meaning 

The specified group name has been defined twice in two different modules. The 
segments contained in the two definitions are different. 

Effect 

The two groups are combined into one. AH segments that were in either group are 
included in the resulting group. Segments with the same segment name, class name, 
and overlay name are combined. LINK86 continues processing. Both the print file 
and object file are valid. 

User Action 

No user action should be necessary. 



ERROR 15: LINK86 ERROR 
FILE: pathname 
MODULE: module name 

User Action 

Contact Intel immediately. Forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 



ERROR 16: STACK OVERFLOW 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86's run time stack used for type matching has overflowed. 

Cause 

The type definition of one of your symbols is overly complex. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Try incremental linkage — if error persists, contact Intel. 
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WARNING 17: SEGMENT OVERFLOW 
SEGMENT: segment name 
CLASS: class name 

Meaning 

The combination of two or more segments has resulted in a segment that exceeds 
64K. 

Effect 

LINK86 continues processing during the current pass, but the print and object files 
are not useable. 

User Action 

Reorganize your segments and reassemble. 



WARNING 18: IMPROPER START ADDRESS 
FILE: pathname 
MODULE: module name 

Meaning 

A start address was found in one of the overlay modules, and none was found in the 
root module. 

Cause 

This error is often caused by misordering the input modules in the input list. 

Effect 

LINK86 ignores the start address in the specified overlay module and continues 
processing. 

User Action 

If you want the module containing the start address to be the root, relink with that 
module first in the input list. 



ERROR 19: TYPE DESCRIPTION TOO LONG 
FILE: pathname 
MODULE: module name 

Meaning 

The type definition is too long to fit in LINK86's symbol table. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents Of 
the print file and the object file are undefined. 

User Action 

Contact Intel immediately. Forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 



D-9 



LINK86 Controls and Error Messages iAPX 86, 88 Family Utilities 

WARNING 20: NO SUCH GROUP 
NAME: group name 

Cause 

You have attempted to rename a nonexistent group. 

Effect 

LINK86 ignores the RENAME control and continues processing. 

User Action 

Reinvoke LINK86 with the correct invocation line. 

WARNING 21: RENAME ERROR 
NAME: name 

Meaning 

The new group name specified is the same as an existing group. 

Effect 

The group is not renamed. LINK86 continues as if the rename control was not given. 

User Action 

Reinvoke LINK86 with the correct invocation line. 



ERROR 22: INVALID SYNTAX 

ERROR IN COMMAND TAIL NEAR # 
partial command tail 

Cause 

This is usually the result of a typo in the invocation line. The partial command tail 
up to the point where the error was detected is printed. 

Effect 

LINK86 terminates processing and closes all open files. The contents of the print file 
and the object file are undefined. 

User Action 

Reinvoke LINK86 more carefully this time. 
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ERROR 23: BAD OBJECT FILE 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has discovered an inconsistency in the fields of a record in the specified 
input file. 

Cause 

This could be an error by the translator or a data transmission error. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Retranslate the source file. If the problem persists contact Intel. 



WARNING 24: CANNOT FIND MODULE 
FILE: pathname 
MODULE: module name 

Meaning 

The specified module cannot be found in the specified library file. 

Effect 

LINK86 continues processing as if the specified module was not in the list. 

User Action 

If the module is important, you can link it into the output object file later. 



WARNING 25: EXTRA START ADDRESS IGNORED 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has encountered a start address in more than one module. 

Cause 

This will occur any time you specify more than one main module in the input list. 

Effect 

LINK86 uses the start address encountered earlier and ignores the start address in 
the specified module. LINK86 continues processing with no other side effects. 

User Action 

None, if the start address in the specified module was intended to be ignored. 
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ERROR 26: NOT AN OBJECT FILE 
FILE: pathname 

Meaning 

The specified file is not an object file. 

Cause 

This is usually the result of a typo when entering. However, certain data trans- 
mission errors can also cause this error. 

Effect 

LINK86 terminates processing and closes all open files. 

User Action 

Reinvoke LINK86 typing the line more carefully. If error resulted from a data 
transmission error, retranslate and then relink. 



ERROR 27: OPERATING SYSTEM INTERFACE ERROR 
FILE: pathname 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Refer to the documentation for your operating system. If you cannot correct the 
error condition, contact Intel; forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 



WARNING 28: POSSIBLE OVERLAP 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 
CLASS: class name 

Meaning 

LINK86 issues this warning when it combines two absolute segments. 

Effect 

LINK86 continues processing with no side effects. 

User Action 

If there is a conflict LOC86 or the loader will detect the overlap. 
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WARNING 29: GROUP HAS BAD EXTERNAL REFERENCE 
GROUP: group name 
SEGMENT: segment name 

Meaning 

This error occurs if the public symbol corresponding to an external reference has 
been specified by its absolute address, and the address does not reside in any 
segment. 

Effect 

LINK86 continues processing and the print and object files will be valid except the 
external reference has not been properly resolved. 

User Action 

Either remove the reference to the public symbol or do not allow the symbol to be 
absolute. 



ERROR 30: LIBRARY IS NOT ALLOWED WITH PUBLICSONLY CONTROL 
FILE: pathname 

Meaning 

The specified file is a library and libraries are not allowed in a PUBLICSONLY 
control. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Remove library file from PUBLICSONLY argument list and reinvoke LINK86. 



WARNING 31: REFERENCED LOCATION OFFSET UNDERFLOW 
FILE: pathname 
MODULE: module name 

Meaning 

While computing the offset for an 8089 self relative reference, LINK86 had a 
negative result. 

Cause 

Either with the ORDER control or the order of files in the input list, the reference 
was separated from its target, or the 8089 segment is too large. 

Effect 

LINK86 continues processing; however, the invalid offset computation is used. 

User Action 

Examine the ORDER control in the invocation line and modify its arguments. 
Reinvoke LINK86 carefully. 
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WARNING 32: EXTRA RE6ISTER INITIALIZATION RECORD IGNORED 
FILE: pathname 
MODULE: module name 

Cause 

You have included two main modules in your input list. 

Effect 

LINK86 uses the first register initialization record and ignores the second. Process- 
ing continues. 

User Action 

If the register initialization information in the specified file and module should be 
used, then modify your input list; otherwise, no user action is necessary. 



ERROR 33: ILLEGAL USE OF OVERLAY CONTROL 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has found an overlay definition in the specifed file and module, while pro- 
cessing input modules for an overlay. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the specified file from the input list and relink. 



ERROR 34: TOO MANY OVERLAYS IN INPUT FILE 
FILE: pathname 
MODULE: module name 

Meaning 

The specified file and module above contains more than one overlay definition. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the specified file from the input list and relink. 
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ERROR 35: SAME OVERLAY NAME IK TWO OVERLAYS 
FILE: pathname 
MODULE: module name 
NAME: name 

Meaning 

The specified file contains an overlay that has the same name as an overlay 
encountered in the input list. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove one of the duplicate names from the input list and relink. If both overlays 
are necessary, relink one overlay specifying a different overlay name. 



ERROR 36: ILLEGAL OVERLAY CONSTRUCTION 
FILE: pathname 
MODULE: module name 

Meaning 

Some of the modules in the input list contain overlay definitions while others do not. 
This is not permitted — all modules in the input list must be the same with respect to 
overlays. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the non-overlay files and relink. 



WARNING 37: DIFFERENT PUBLICS FOR EXTERNAL IN ROOT 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has found two symbol definitions in the overlay modules that resolve an 
external symbol definition in the root. 

Effect 

LINK86 ignores the definition in the specified file and module, and continues pro- 
cessing with no side effects. 

User Action 

Remove the unwanted symbol definition and relink. 
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ERROR 38: INVALID OVERLAPPING GROUPS 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 
GROUP: group name 

Meaning 

While binding the input list LINK86 found a segment that was defined to be within 
two groups. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Either modify the source to remove the segment from one of the groups or do not 
link with the BIND control. 



ERROR 39: SPECIFIED GROUP NOT FOUND IN INPUT MODULE 
GROUP: group name 

Cause 

Often this is the result of a typographical error in the invocation line. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the invocation line and relink. 



ERROR 40: SPECIFIED SEGMENT NOT FOUND IN THE GROUP 
SEGMENT: segment name 
GROUP: group name 

Cause 

Usually this is the result of a typographical error in the ORDER control. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the invocation line and relink. 
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ERROR 41: SPECIFIED SEGMENT NOT FOUND IN INPUT MODULE 
SEGMENT: segment name 
CLASS: class name 

Cause 

Usually this is the result of a typographical in the SEGSIZE control. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined . 

User Action 

Find the module that contains the specified segment and add it to the input list. 



WARNING 42: DECREASING SIZE OF SEGMENT 
SEGMENT: segment name 

Meaning 

The size change specified in SEGSIZE has caused LINK86 to decrease the size of the 
specified segment. 

Effect 

Decreasing the size of a segment can cause sections of code to be unaccounted for 
during the memory allocation process. LINK86 continues processing with no side 
effects. 

User Action 

None if the size decrease was intended. 



ERROR 43: SEGMENT SIZE OVERFLOW; OLD SIZE + CHANGE > 64K 
SEGMENT: segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment to become 
greater than 64K. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Reinvoke LINK86 with the correct SEGSIZE control. 
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ERROR 44: SEGMENT SIZE UNDERFLOW; OLD SIZE + CHANGE < 
SEGMENT: segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment's size to be 
less than zero. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Reinvoke LINK86 with the correct SEGSIZE control. 



ERROR 45: THE SEGMENT MAXIMUM SIZE IS LESS THAN THE 
SEGMENT MINIMUM SIZE 
SEGMENT: segment name 
CLASS: class name 

Cause 

Usually this is the result of a typographical error in the SEGSIZE control. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the invocation line and relink. 



ERROR 46: ILLEGAL USE OF SEGSIZE CONTROL 
SEGMENT: segment name 
CLASS: class name 

Cause 

A maximum size was specified for either a stack segment, an absolute segment, or a 
segment that is not the highest component of its group. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the specified segment from the SEGSIZE control and relink. 
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WARNING 47: GROUP HAS NO CONSTITUENT SEGMENTS 
6 R U P : group name 

Meaning 

The group has no segments and is not placed in the output object file. 

Cause 

Often this is the result of a typographical error in the invocation line. 

Effect 

LINK86 does not place the specified group in the object file and continues process- 
ing with no side effects. 

User Action 

Unless there is some particular need for the specified group, no user action is 
necessary. 



WARNING 48: SIZE OF GROUP EXCEEDS 64K 
GROUP: group name 

Meaning 

All of the segments that belong to the specified group do not fit within the physical 
segment defined for that group. 

Cause 

This error is usually caused by misuse of the SEGSIZE or ORDER controls. 

Effect 

LINK86 includes all segments in the object file and continues processing the input 
module. The output module will be executable, although addressing errors may 
occur. 

User Action 

Examine the invocation line and reinvoke LINK86 using the SEGSIZE or ORDER 
control more carefully. 
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WARNING 49: MAXIMUM SIZE OF GROUP EXCEEDS 64K 
GROUP: group name 

Meaning 

The maximum segment size for the segments contained in the specified group 
exceeds 64K. 

Cause 

This error is usually caused by misuse of the SEGSIZE control. 

Effect 

LINK86 reduces the maximum size of the group and its constituent segments. 
LINK86 continues processing the input module. The output module will be 
executable. 

User Action 

No action is necessary. If you want to remove the error, examine the invocation line 
and reinvoke LINK86 using the SEGSIZE control more carefully. 



WARNING 50: MORE THAN ONE SEGMENT WITH THE MEMORY 
ATTRIBUTE 
SEGMENT: segment name 

Meaning 

After the first memory segment is found, LINK86 issues this warning each time it 
finds a segment with the memory attribute. 

Effect 

LINK86 ignores the memory attribute on the segment specified in the message. 
Processing continues with LINK86 treating the additional memory segment as just 
another segment. 

User Action 

Depending on your intentions, this message may be ignored or you may wish to 
change the segment definition and relink. 



WARNING 51: SEGMENT WITH MEMORY ATTRIBUTE NOT PLACED 
HIGHEST IN MEMORY 
SEGMENT: segment name 

Meaning 

The specified memory segment was not located at the highest offset in its group. 

Cause 

This can only occur when you explicitly request this organization through the 
ORDER control. 

Effect 

Since this can only occur by user request, LINK86 continues processing without side 
effects. 
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WARNING 52: OFFSET FIXUP OVERFLOW 
FILE: pathname 
MODULE: module name 

Meaning 

While computing an offset from a base, LINK86 found that the offset was greater 
than64K. 

Cause 

One of the segments of a group is outside the 64K frame of reference defined by its 
group base. 

Effect 

LINK86 continues processing. The print file will be valid, but the output file with 
regard to the out of place segment will not be usable. 

User Action 

Modify the group definitions in your source and retranslate. 



WARNING 53: OVERFLOW OF LOW BYTE FIXUP VALUE 
FILE: pathname 
MODULE: module name 

Meaning 

An 8-bit displacement value, when calculated, exceeded 255. 

Cause 

This type of error often occurs when a page resident segment crosses a page 
boundary. 

Effect 

LINK86 continues processing. The contents of both the print file and the object file 
will be valid. However, the fixup value will remain invalid. 

User Action 

Organize your segments so that the addressing error will not be encountered. 

ERROR 54: ILLEGAL USE OF ORDER CONTROL 
GROUP: group name 

Meaning 

The specified group's segments have already been ordered. 

Cause 

You are attempting to relink a file that has been linked with the BIND control. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Relink using the unbound input modules. 
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ERROR 55: ILLEGAL FIXUP 
FILE: pathname 
MODULE: module name 

Meaning 

While processing a fixup record, LINK86 found that the base for the reference and 
target are different. 

Cause 

This is usually a coding error. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Examine your assembly language source and retranslate. 



ERROR 56: DATA ADDRESS OUTSIDE SEGMENT BOUNDARIES 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 

Meaning 

One of the data records associated with the specified segment contains an address 
outside of the segment's boundary. 

Cause 

This error can occur when you decrease the size of a segment. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Change SEGSIZE control and relink. 



ERROR 57: MAXIMUM DYNAMIC STORAGE LESS THAN MINIMUM 
DYNAMIC STORAGE 

Meaning 

The size change specified in MEMPOOL has caused the maximum dynamic storage 
to be less than the minimum dynamic storage. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Reinvoke LINK86 with correct arguments to MEMPOOL. 
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WARNING 58: NO START ADDRESS SPECIFIED IN INPUT MODULES 

Meaning 

The BIND control was specified, and none of the input modules has a start address. 

Cause 

The input list contains no main module. 

Effect 

The CS andJP registers remain uninitialized, and their values are dependent on your 
system loader. The object module will be valid. 

User Action 

Reinvoke LINK86 with a main module or execute LOC86 with the START control. 



ERROR 59: I/O ERROR WITH ROOT-FILE IN ASSUMEROOT CONTROL 
FILE: pathname 
operating system message 

Meaning 

The ASSUMEROOT control was specified, but the root file identified by pathname 
in the invocation could not be accessed. 

Effect 

LINK86 immediately terminates processing. 

User Action 

Refer to your operating system documentation to correct the condition, then rein- 
voke LINK86. 



ERROR 60: OUTPUT FILE IS SAME AS INPUT FILE 
FILE: pathname 

Meaning 

LINK86 detected an output pathname identical to an input pathname. 

Cause 

The pathnames of the specified input file and the output file were identical. 

Effect 

LINK86 terminates processing immediately. 

User Action 

Reinvoke LINK86 after fixing the duplicate-name situation. 
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ERROR 61: ROOT-FILE IN ASSUMEROOT CONTROL IS NOT PROPER 
OBJECT FILE 
FILE: pathname 

Meaning 

The ASSUMEROOT control was specified, but the root file is not found to have an 
overlay record in it. 

Cause 

The root file needs an overlay record. 

Effect 

LINK86 terminates processing immediately. 

User Action 

Relink the root file using the OVERLAY control. 



WARNING 62: ASSUMEROOT CONTROL MEANINGFUL ONLY WITH 
OVERLAYS 

Meaning 

The ASSUMEROOT control should be used only when the input modules do not 
contain overlay records. 

Cause 

ASSUMEROOT was specified, but not in conjunction with the OVERLAY control. 

Effect 

LINK86 ignores the ASSUMEROOT control. The object code is valid. 

User Action 

Reinvoke LINK86, using the OVERLAY and ASSUMEROOT controls. 



WARNING 63: BAD SEGMENT ALIGNMENT 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 

Meaning 

The segment is not paragraph/page-aligned. 

Cause 

The object code has references to the base of the specified segment, and the segment 
is not declared as paragraph/page-aligned. 

Effect 

Although the object module will be valid, the loader may not load the program 
correctly. 

User Action 

Declare the specified segment to be paragraph/page-aligned. 
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WARNING 64: PUBLIC SYMBOLS NOT SORTED DUE TO INSUFFICIENT 
MEMORY 

Meaning 

The amount of memory required to sort the public symbols for the LINK86 print file 
listing is insufficient. 

Cause 

The number of public symbols in the input-list modules is too large for LINK86 to 
sort with the available memory resources. 

Effect 

The LINK86 print file listing provides public symbols in the order in which they were 
encountered in the input files. This condition has no effect on the correctness or 
validity of the output module. 

User Action 

Increase the amount of available RAM or decrease the number of public symbols. 



WARNING 65: ILLEGAL FIXUP: INCORRECT DECLARATION OF 
EXTERNAL SYMBOL 
FILE: pathname containing external declaration 
MODULE: name of module containing external declaration 
SYMBOL: name of external symbol 
FRAME: identification of reference location 
TARGET: identification of target location 

Meaning 

The declaration of the specified SYMBOL was found to be inconsistent with a 
corresponding public symbol definition, and LINK86 could not resolve the 
reference. 

Cause 

This condition may exist for several reasons. The modules containing the external 
and public symbols may have been compiled under different translator controls 
(e.g., SMALL, LARGE). In the case of assembly language programs, the SYMBOL 
may be defined in a group, segment, or frame different from that in which it is 
declared as external. Or an attempt has been made to access absolute entry points 
from pre-located code without using the PUBLICSONLY control explicitly. 

Effect 

LINK86 internally converts these illegal fixups to legal formats to identify all 
occurrences in a single execution. Thus the output object module may not be cor- 
rect, although it will be a valid 8086 object module. 

User Action 

If the warning occurred because of an attempted access of absolute entry points 
from pre-located code, use the PUBLICSONLY control in conjunction with the file 
that contains public definitions for those entry points. Otherwise, use the FRAME 
and TARGET information given in the warning message to pinpoint the source of 
the error, then correct the code. 
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For example: 

WARNING 65: ILLEGAL FIXUP: INCORRECT DECLARATION OF 
EXTERNAL SYMBOL 
FILE: EXTFIL 
MODULE: EXTMODULE 
SYMBOL: EXTSYM 
FRAME: GROUP - GR0UP1 
TARGET: SEGMENT - SEGMENT5 

The symbol EXTSYM is declared to be in SEGMENT5. The external-public resolu- 
tion specified that the calculations be made with respect to the base of GROUP 1, 
but the segment SEGMENT5 is not in GROUP 1 . 



WARNING 66: CS AND IP REGISTERS ARE NOT INITIALIZED 

Meaning 

The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of 8086 registers. CS means code segment 
register, and IP means instruction pointer. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of CS and IP at the beginning of program execution are entirely depen- 
dent on the loader of your system. The object code will be valid. 

User Action 

Retranslate your code, then reinvoke LINK86. 



WARNING 67: SS AND SP REGISTERS ARE NOT INITIALIZED 

Meaning 

The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of 8086 registers. SS means stack segment and 
SP means stack pointer. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of SS and SP at the beginning of program execution are entirely depen- 
dent on the loader of your system. The object code will be valid. 

User Action 

Correct your code if necessary, then reinvoke LINK86. 
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WARNING 68: DS REGISTER NOT INITIALIZED 

Meaning 

The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of the 8086 DS (data segment) register. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The value of the DS register at program execution is entirely dependent on the loader 
of your system. 

User Action 

Correct your code if necessary, then reinvoke LINK86. 



WARNING 69: OVERLAPPING DATA RECORDS 

Meaning 

The FASTLOAD control was specified, and two data records belonging to the same 
segment have offsets which make them overlapping. 

Cause 

This warning is usually the result of a translation error, unless you have intentionally 
overlapped data records. 

Effect 

LINK86 ignores the second record and does not include it in the output file. The 
code will be unusable. 

User Action 

If you want an overlap condition to exist, reinvoke, but do not use the FASTLOAD 
control. Otherwise, retranslate, then reinvoke LINK86. 



WARNING 70: INITCODE CONTROL INEFFECTIVE WITH BIND 
CONTROL 

Meaning 

The INITCODE and BIND controls were combined in one invocation statement. 

Effect 

The INITCODE control will be ignored by LINK86. 

User Action 

Do not invoke LINK86 using both of these controls at the same time. To invoke 
them separately, use the INITCODE control first, then the BIND control during a 
second invocation. 
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WARNING 71: TOO MANY MAIN MODULES IN INPUT 
FILE: pathname 
MODULE: module name 

Meaning 

LINK86 discovered two or more main modules (modules with start addresses) in the 
input list. 

Cause 

The input list contains too many main modules. 

Effect 

LINK86 uses the start address of the first main module it reads and ignores the 
others. The object code will be valid. 

User Action 

Ensure that the LINK86 interpretation is suitable to your objectives. If not, modify 
the input list, and reinvoke LINK86. 



WARNING 72: REGISTER INITIALIZATION CODE EXISTS, NEW 
INITIALIZATION IGNORED 
FILE: pathname 
MODULE: module name 

Meaning 

Two or more initialization codes for 8086 registers were encountered in the input 
list. 

Cause 

This condition resulted from a translation or linkage problem. 

Effect 

LINK86 uses the first initialization code and ignores the others. The object code will 
be valid. 

User Action 

If retranslating or relinking does not correct the error, contact Intel. 



WARNING 73: INITCODE CONTROL INEFFECTIVE WITH OVERLAYS 

Meaning 

Both INITCODE and OVERLAY controls were specified. 

Effect 

The INITCODE control is ignored. The object code will be valid. 

User Action 

Reinvoke LINK86, using the INITCODE control. In a second invocation, specify 
the OVERLAY control. 
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ERROR 74: PRINT FILE SAME AS INPUT FILE 
FILE: pathname 

Meaning 

The pathnames of the print file and one of the input files are identical. 

Effect 

LINK86 terminates processing immediately. 

User Action 

Reinvoke LINK86 after fixing the duplicate-name situation. 

ERROR 75: PRINT FILE SAME AS OUTPUT FILE 

Meaning 

The names of the print and output files are identical. 

Cause 

The invocation line included duplicate names. 

Effect 

LINK86 terminates processing immediately. 

User Action 

Correct the invocation line and reinvoke LINK86. 

WARNING 76: BASE OF REFERENCED SEGMENT DIFFERS FROM BASE 
OF CONTAINING GROUP 
FILE: pathname 
GROUP: group name 
MODULE: module name 
SEGMENT: segment name 

Meaning 

An assembly language reference to the base of the specified segment in the specified 
group exists. However, the specified segment is not the first segment in the group. 
This warning occurs only when BIND is in effect. 

Cause 

Unless you have deliberately created this reference, this warning is most likely the 
result of an incorrect ASSUME directive or an incorrect OFFSET operator 
specification. 

Effect 

LINK86 will process the specified reference to the segment base rather than to the 
group base. The output module will be valid. 

User Action 

If the reference to the segment base was deliberate, continue debugging your 
assembly language code as planned. Otherwise, check the correctness of the code, 
particularly the ASSUME directives and OFFSET operator specifications; then 
reassemble and relink. 
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WARNING 77: REFERENCED OFFSET IN SEGMENT DIFFERS FROM 
OFFSET FROM GROUP BASE 
FILE: pathname 
GROUP: group name 
MODULE: module name 
SEGMENT: segment name 

Meaning 

An assembly language reference to an offset from the base of the specified segment 
in the specified group exists. However, the specified segment is not the first segment 
in the group. This warning occurs only when BIND is in effect. 

Cause 

Unless you have deliberately created this reference, this warning is most likely the 
result of an incorrect ASSUME directive or an incorrect OFFSET operator 
specification. 

Effect 

LINK86 will process the specified reference as an offset from the segment base 
rather than the group base. The output module will be valid. 

User Action 

If the reference to the offset in the segment was deliberate, continue debugging your 
assembly language code as planned. Otherwise, check the correctness of the code, 
particularly the ASSUME directives and OFFSET operator specifications; then' 
reassemble and relink. 
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CREF86 CONTROLS 

AND ERROR MESSAGES 



Table E-l lists all of CREF86's control syntax, abbreviations, and default settings. 



Table E-l . Summary of CREF86 Controls 



Control 


Abbrev. 


Default 


PAGELENGTH(num&e/-) 


PL 


PAGELENGTH(60) 


PAGEWIDTH(num6er) 


PW 


PAGEWIDTH(120) 


PRINT {pathname) 


PR 


PRINT (first input file . CRF) 


T\TLE(character-string ) 


TT 


Not applicable 



The following are descriptions of all CREF86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning — how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect — the state of CREF86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 



Error messages are always fatal, but warning messages are not. 



Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 



ERROR 1 : I/O ERROR 

operating system message explaining the cause of this erorr 
FILE: pathname 

Meaning 

An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 

Effect 

CREF86 immediately terminates processing; all open files are closed. The contents 
of the print file are undefined. 

User Action 

Correct the error and restart CREF86. 
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ERROR 2: SYNTAX ERROR IN INPUT COMMAND 

Meaning 

An error in the syntax of the invocation line was detected. 

Cause 

This condition is usually the result of a typographical error or transposition. 

Effect 

The invocation command line, to the point it is parsed, is written to the console with 
a # following this string. 

User Action 

Correct the syntactic error and retransmit the invocation line(s). 

ERROR 3: OUT OF MEMORY 

Meaning 

CREF86 does not have enough memory to create its internal data structures, tables, 
etc. This condition may also occur because of inadequate disk space for temporary 
files. 

Cause 

The input list contains too many symbols and/or too many references among them. 

Effect 

CREF86 immediately terminates processing, closing all open files. The contents of 
the print file are undefined. 

User Action 

Ensure that adequate resources are available to run CREF86. 



ERROR 4: I/O ERROR 

operating system error message 
FILE: pathname 

Meaning 

An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 

Effect 

CREF86 processing is immediately terminated. 

User Action 

Correct the error and restart CREF86. 
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ERROR 5: IMPROPER OBJECT MODULE 
FILE: pathname 
MODULE: module name 

Meaning 

The specified module does not meet 8086 object module requirements. 

Cause 

This condition may be caused by the translator or by an error in data transmission. 

Effect 

CREF86 processing is immediately terminated. 

User Action 

Try retranslating the source file. If the problem persists, call Intel. 

ERROR 6: PREMATURE EOF 
FILE: pathname 

Meaning 

CREF86 expects more input data, but encounters an end-of-file (EOF) condition. 

Cause 

This condition usually results from a translator error. 

Effect 

CREF86 processing is immediately terminated. 

User Action 

Return to the previous step in program development, then retranslate or relink. 

ERROR 7: LIBRARY SEEK ERROR 
FILE: pathname 
MODULE: module name 

Meaning 

CREF86 did not encounter a proper library record when scanning a library file. 

Cause 

The library file or the disk may be corrupted. 

Effect 

CREF86 immediately terminates processing. 

User Action 

Reinvoke CREF86 after replacing the file or the disk. 
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ERROR 8: LIBRARY IN OVERLAY MODE 
FILE: pathname 

Meaning 

An input list contains object file(s) with an overlay record count greater than zero 
and a library file. 

Cause 

Libraries cannot contain overlay records. CREF86 can process either all modules or 
no modules with overlay records. 

Effect 

CREF86 immediately terminates processing. 

User Action 

Reinvoke CREF86 using a valid input list. 



ERROR 9: IMPROPER MODULE SEQUENCE 
FILE: pathname 
MODULE: module name 

Meaning 

A combination of modules containing overlay records with those containing 
nonoverlay records was encountered in the input list. 

Cause 

CREF86 can process input lists consisting of either all modules with overlay records 
or no modules with overlay records. 

Effect 

CREF86 immediately terminates processing. 

User Action 

Reinvoke CREF86 with a valid input list. 
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ERROR 10: MORE THAN 255 OVERLAYS NOT SUPPORTED 

Meaning 

The input list contains over 255 files with overlay records. 

Cause 

CREF86 does not support more than 255 overlay files. In the case of input lists 
without overlays, however, there is no limit (except available memory) on the 
number of files CREF86 can process. 

Effect 

CREF86 immediately terminates processing. 

User Action 

Reinvoke CREF86 using fewer than 255 overlay files. 



ERROR 11: TOO MANY OVERLAYS 
FILE: pathname 
MODULE: module name 

Meaning 

The input file contains more than one overlay. 

Cause 

CREF86 can support files with only one overlay record each. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Reinvoke CREF86 with an input list containing files with no more than one overlay 
each. 
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ERROR 12: I/O ERROR 
operating system error message 
FILE: pathname 

Meaning 

An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Correct the error and restart CREF86. 



ERROR 13: IMPROPER PAGE WIDTH SPECIFICATION 

Meaning 

The PAGEWIDTH control specification includes a number outside the valid 
syntactic range. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Correct the syntax error and reinvoke CREF86. CREF86 accepts a PAGEWIDTH 
number in decimal form from 80 to 132, inclusive, in the following format: 

PAGEWIDTH (number) 
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ERROR 14: IMPROPER PAGE LENGTH SPECIFICATION 

Meaning 

The PAGELENGTH control specification includes a number outside the valid 
syntactic range. 

Effect 

CREF86 terminates processing immediately. 

User Action 

.Reinvoke CREF86 using the proper PAGELENGTH syntax. CREF86 accepts a 
PAGELENGTH number in decimal form from 10 through 255, in the following 
format: 

PAGELENGTH (number) 



ERROR 15: ILLEGAL LIBRARY FILE 
FILE: pathname 

Meaning 

CREF86 did not encounter a proper library record in the proper location. 

Cause 

The library file or disk may be corrupted. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Reinvoke CREF86 after replacing the file or the disk. 
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ERROR 16: IMPROPER OBJECT FILE 
FILE: pathname 
MODULE: module name 

Meaning 

CREF86 did not encounter an 8086 object module record in the proper location. 

Cause 

The object file may be corrupt or the file may not be an 8086 object file. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Determine whether the integrity of the object file is intact and whether the file is a 
proper input file for CREF86. Reinvoke CREF86 with a valid and usable object file. 



ERROR 17: OUTPUT FILE SAME AS INPUT FILE 
FILE: pathname 
MODULE: module name 

Meaning 

CREF86 detected an output pathname identical to an input pathname. 

Cause 

The invocation line specified two identical pathnames. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Reinvoke CREF86 after fixing the duplicate-name situation. 
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ERROR 18: CREF86 INTERNAL ERROR 
FILE: pathname 
MODULE: module name 

User Action 

Contact Intel immediately. Forward a copy of the object file, the CREF86 invoca- 
tion line, and your version of CREF86. 



WARNING 19: TYPE MISMATCH 
FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 

Meaning 

CREF86 detected a type mismatch between two symbols with the same name. 

Cause 

Two symbols are declared to have identical names but different types, and the 
symbols are not in different overlay modules. 

CREF86 does not check the entire TYPE declaration for any given symbol. For 
example, dimension values for arrays, number of parameters in procedure calls, etc. 
are not compared. Only simple types (e.g., byte, word, structure) are checked. 

Effect 

CREF86 flags the condition in the cross-reference listing. 

User Action 

Ensure that the condition is not damaging to your programming objectives. 



E-9 



CREF86 Controls and Error Messages iAPX 86,88 Family Utilities 

WARNING 20: SPECIFIED MODULE NOT FOUND 
FILE: pathname 
MODULE: module name 

Meaning 

A module explicitly included in the input list of the invocation is not found by 
CREF86. 

Cause 

The specified module is not part of the file specified by the pathname. 

Effect 

CREF86 continues processing the modules it is able to find. 

User Action 

Determine why the module is missing, then reinvoke CREF86. 



ERROR 21: OPERATING SYSTEM INTERFACE ERROR 
operating system error message 

Meaning 

CREF86 cannot open its temporary file. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Refer to the documentation on the operating system to help diagnose any possible 
operating system malfunction. 
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LIB86 COMMANDS 

AND ERROR MESSAGES 



The table below shows all of LIB86's commands. 

Table F-l . Summary of LIB86 Commands 



Command 


Abbrev. 


Description 


ADD <.pathname[(module name [,...])]> 
[,...] TO pathname 


A 


Adds modules to a library 


CREATE pathname 


C 


Creates a library file 


DELETE pathname(module name [,...]) 


D 


Deletes modules from a library 
file 


EXIT 


E 


Terminates session with LIB86 


LIST <.pathname[(module name [,..-])]> 
[,.... 1 [TO pathname] [PUBLICS] 


L 
[P] 


Lists modules contained in a 
library file, and optionally lists 
all publics 



The following are descriptions of all LIB86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning — how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect— the state of LIB86 and the object f ile(s) after the message is issued 

• User Action — what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error and warning messages are displayed at the console device. 



MODULE NOT FOUND 
MODULE: module name 
FILE: pathname 

Meaning 

The specified module could not be found in the specified library. 

Cause 

There is a typographical error in the command line. 

Effect 

L1B86 ignores the module in the list and continues processing. 

User Action 

No user action is necessary. 
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RIGHT PARENTHESIS EXPECTED 
partial command tail 



LEFT PARENTHESIS EXPECTED 
partial command tail 



INVALID MODULE NAME 
partial command tail 



MODULE NAME TOO LONG 
partial command tail 



INVALID SYNTAX 
partial command tail 



'TO' EXPECTED 
partial command tail 

Meaning 

All of the above errors are syntax errors. For each of the above errors LIB86" issues 
the associated error message and displays the partial command up to the point of the 
error. 

Cause 

There is a typographical error in the command line. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Examine the command line, make the necessary corrections and reissue the 
command. 
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UNRECOGNIZED COMMAND 

Cause 

You mistyped a command (ADD, CREATE, DELETE, EXIT, or LIST). 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Examine the command line and enter the corrected command. 

INSUFFICIENT MEMORY 

Meaning 

There is not enough memory available to execute the command. 

Cause 

Exceptionally long and complex commands can cause this error. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Simplify your command line and reexecute. 



COMMAND LINE TOO LONG 
partial command tail 

Meaning 

The length of the LIB86 command you tried to execute exceeded the size limit of the 
system's command buffer. 

Effect 

LIB86 immediately terminates processing the command, displays this error message 
plus the portion of the command it would accept, then issues the prompt character 

User Action 

Simplify your command line and reexecute. 
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LIB86 ERROR 

Meaning 

LIB86 failed an internal consistency check. 

Effect 

LIB86 immediately terminates processing. The results of previous commands on the 
library being manipulated when this error occurred may have been lost. 

User Action 

Contact Intel. Forward a copy of the libraries and object files used during the 
session in which the error occurred. 



FILE ALREADY EXISTS 
FILE: pathname 

Meaning 

The file specified in the CREATE command already exists. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Specify a nonexistent file in the CREATE command. 



DUPLICATE SYMBOL IN INPUT 
SYMBOL: symbol name 
MODULE: module name 
FILE: pathname 

Meaning 

The specified public symbol conflicts with a public symbol defined in one of the files 
given earlier in the input list. This error occurs only during the ADD command. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). The library being manipulated returns to the 
state it was in prior to the ADD command that prompted this message. 

User Action 

Correct the ADD command and reinvoke LIB86. 
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NOT A LIBRARY 
FILE: pathname 

Cause 

The file that the command requests LIB86 to DELETE or LIST is not a library file. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Reissue the command specifying a library file. 



ILLEGAL RECORD FORMAT 
MODULE: module name 
FILE: pathname 

Cause 

This error is usually caused by a transcription error or translation error in some part 
of an object file examined by LIB86. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Return to the last step in program development, then retranslate, relink, or relocate. 



PREMATURE EOF 
MODULE: module name 
FILE: pathname 

Meaning 

Due to some transcription error or other the specified file has no module end record. 

Cause 

This is usually the result of a transcription error or translator error. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Return to the last step in program development, then restranslate, relink, or 
relocate. 
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CHECKSUM ERROR 
MODULE: module name 
FILE: pathname 

Meaning 

The specified file has an error in one of its checksum fields. 

Cause 

This is the result of a transcription error. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 

and issues the prompt character (*). 

* 

User Action 

Return to the last step in program development, then retranslate, relink, or relocate. 



ATTEMPT TO ADD DUPLICATE MODULE 
MODULE: module name 

Meaning 

A module with the specified module name already exists in the library. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Remove the duplicate module from the list and reissue the command. 



ATTEMPT TO ADD MODULE CONTAINING OVERLAYS 
MODULE: module name 
FILE: pathname 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). All modules in the input list up to the erroneous 
file are added to library. 

User Action 

Reissue the command with all elements in the input list except those that contain 
overlays. 
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PUBLIC SYMBOL ALREADY IN LIBRARY 
SYMBOL: symbol name 
MODULE: input module name 
FILE: input pathname 

Meaning 

The library already contains the public symbol identified in the error message. 

Cause 

This error occurs when a module is added that has a symbol definition already in the 
library. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Reexecute the command without the file that contains the duplicate symbol. 
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Table G-l lists all of LOC86's control syntax, abbreviations, and default settings. 
Table G-l . Summary of LOC86 Controls 



Control 


Abbrev. 


Default 


ADDRESSES( 

iSEGMEU7S{isegment[\class[\overlay]] 
(addr) >[,...]) | 
CLASSES(tc/ass(arfc/r)>[ > ...] | 
GROUPS(igroup(addr)y[,...]) > 


AD 

(SM| 

CS | GR) 


Not applicable 


BOOTSTRAP 


BS 


Not applicable 


COMMENTS 


CM 


COMMENTS 


NOCOMMENTS 


NOCM 


M\TCODE[(address)] 


IC 


INITCODE(200H) 


NOINITCODE 


NOIC 


LINES 


LI 


LINES 


NOLINES 


NOLI 


MAP 


MA 


MAP 


NOMAP 


NOMA 


NAME(/noc/u/e name) 


NA 


Not applicable 


OBJECTCONTROLS( 

{LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS | NOPUBLICS | 
PURGE | NOPURGE} [,...]) 


OC 


Not applicable 


ORDER( 

iSEGMEHTS(isegment[\class[\overlay]]> 

[,-]> 1 
CLASSES«class[{segment [,...])]> [,...])> 


OD 
(SM| 
CS) 


Not applicable 


PRINT[(pa//jname)] 


PR 


PRINT(o6/ec tfUe .M P2) 


NOPRINT 


NOPR 


PRINTCONTROLS( 

{LINES ) NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS | NOPUBLICS | 
PURGE | NOPURGE} [,...]) 


PC 


Not applicable 


PUBLICS 


PL 


PUBLICS 


NOPUBLICS 


NOPL 


PURGE 


PU 


NOPURGE 


NOPURGE 


NOPU 
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Table G-l . Summary of LOC86 Controls (Cont'd.) 



Control 


Abbrev. 


Default 


RESERVE({acWr TO addrt [,...]) 


RS 


Not applicable 


SEGSlZE(isegment[\class[ \overlay]] 
(s/ze)J[,...]) 


SS 


Not applicable 


START(-Cs//njbo/ | paragraph, offset}) 


ST 


Not applicable 


SYMBOLS 


SB 


SYMBOLS 


N0SYMB0LS 


hfOSB 


SYMB0LC0LUMNSK1 |2|3| 4» 


SC 


SYMBOLCOLUMNS (2) 



The following are descriptions of all LOC86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning— how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect— the state of LOC86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the code 
is valid. 

Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 



ERROR 1: I/O ERROR: 
operating system error message 

Meaning 

An I/O error was detected. Refer to the documentation for your operating system 
for interpretation. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Correct the error and restart LOC86. 
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ERROR 2: INVALID SYNTAX 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

A syntax error was detected in the invocation line. LOC86 repeats the invocation 
line up to the point of the error. 

Cause 

This is usually the result of a typographical error in the invocation line. 

Effect 

LQC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reenter the invocation line more carefully. 



ERROR 3: MISSING INPUT FILE NAME 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

LOC86 was unable to find the input file name in the invocation. LOC86 repeats the 
invocation line up to the point of the error. 

Cause 

This is usually the result of a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 
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ERROR 4: INSUFFICIENT MEMORY 

Meaning 

The memory available on your system has been used up by LOC86. 

Cause 

This can be caused by an input module that has a very large number of segments or 
an impossibly long invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

This may require changing the source file to reduce the number of segments and 
retranslating. 



ERROR 5: BAD RECORD FORMAT 
MODULE: module name 

Meaning 

There is a record in the specified input module that has an incorrect format. 

Cause 

This is usually a transcription error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Retranslate and relink the input files before attempting to locate the input module 
again. 



G-4 



iAPX 86,88 Family Utilities LOC86 Controls and Error Messages 

ERROR 6: INVALID KEY WORD 

ERROR IN COMMAND TAIL REAR-*: 
partial command tail 

Meaning 

One of the controls or subcontrols in the invocation line is incorrect. LOC86 repeats 
the invocation line up to the point of the error. 

Cause 

This is usually the result of a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more correctly. 



ERROR 7: NUMERIC CONSTANT LARGER THAN 20 BITS 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

You have specified an address greater than 1,048,575 (OFFFFFH). LOC86 repeats 
the invocation line up to the point of the error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and invoke LOC86 with the correct address. 



ERROR 8: NON NUMERIC CHARACTER IN NUMERIC CONSTANT 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

This is a type of syntax error. LOC86 repeats the invocation line up to the point of 
the error. 

Cause 

This is usually caused by a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Enter the invocation more carefully. 
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ERROR 9: NUMERIC CONSTANT LARGER THAN 16 BITS 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

You have specified an offset greater than 65,536 (OFFFFH). LOC86 repeats the 
invocation line up to the point of the error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Retype the invocation line more carefully. 



ERROR 10: INVALID SEGMENT NAME 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

LOC86 was expecting a segment name when it found a token that does not cor- 
respond to a valid segment name. LOC86 repeats the invocation line up to the point 
of the error. 

Cause 

This is usually the result of a typographical error. 

Effect 

LOC86 immediately terminates processing; air open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 
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ERROR 11: INVALID CLASS NAME 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

LOC86 was expecting a class name when it found a token that does not correspond 
to a valid class name. LOC86 repeats the invocation line up to the point of the error. 

Cause 

This is usually the result of a typographical error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 



ERROR 12: INVALID INPUT MODULE 
MODULE: module name 

Meaning 

The input module is invalid. It could mean that object module records are out of 
order, or LOC86 has found an invalid field within a record, or a required record is 
missing. 

Cause 

This is usually caused by a translator error or an attempt to locate something other 
than an object file (e.g., a source file). 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Retranslate source and relink, then try to locate again. If this error continues contact 
Intel. 
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WARNING 13: MORE THAN ONE SEGMENT WITH THE MEMORY 
ATTRIBUTE 
SEGMENT: segment name 

Meaning 

After the first memory segment is found, LOC86 issues this warning each time it 
finds a segment with the memory attribute. 

Effect 

LOC86 ignores the memory attribute on the segment specified in the message. Pro- 
cessing continues with LOC86 treating the additional memory segment as just 
another segment. 

User Action 

Depending on your intentions, this message may be ignored or you may wish to 
change the attribute for the segments and relink them. 



WARNING 14: GROUP DEFINED BY AN EXTERNAL REFERENCE 
NAME: external name 
GROUP: group name 

Meaning 

The specified group is defined by an external reference. This is a type of unresolved 
external reference. 

Effect 

LOC86 continues processing without side effects. 

User Action 

Find the module that defines the specified symbol and relink the input module. 



WARNING 15: PUBLIC SYMBOL NOT ADDRESSABLE 
NAME: public symbol name 

Meaning 

The specified symbol is more than 64K from its base. This error occurs when the seg- 
ment containing the public symbol is not completely contained within the 64K 
physical segment defined by the symbol's base. 

Effect 

LOC86 continues processing. The object file will be executable. However, any 
attempt to access the specified public symbol will not produce the desired results. 
Debug symbols with this attribute will not be added to the object file. 

User Action 

Change the ORDER or ADDRESSES control so that the segment containing the 
public symbol will be within range of the symbol's base. 



G-8 



iAPX 86,88 Family Utilities LOC86 Controls and Error Messages 



WARNING 16: LOCAL SYMBOL NOT ADDRESSABLE 
NAME: local symbol name 

Meaning 

The specified symbol is more than 64K from its base. This error occurs when the seg- 
ment containing the local symbol is not completely contained within the 64K 
physical segment defined by the symbol's base. 

Effect 

LOG86 continues processing. The object file will be executable. However, any 
attempt to access the specified symbol will not produce the desired results. Debug 
symbols with this attribute will not be added to the object file. 

User Action 

Change the ORDER or ADDRESSES control so that the segment containing the 
local symbol will be within range of the symbol's base. 



WARNING 17: LINE NUMBER NOT ADDRESSABLE 
NAME: line number 

Meaning 

The specified line is more than 64K from its base. This error occurs when the seg- 
ment containing the line number is not completely contained within the 64K physical 
segment defined by the line's base. 

Effect 

LOC86 continues processing. The object file will be executable. However, any 
attempt to access the specified line number will not produce the desired results. 
Debug symbols with this attribute will not be added to the object file. 

User Action 

Change the ORDER or ADDRESSES control so that the segment containing the line 
number will be within range of the line's base. 
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WARNING 18: SIZE OF GROUP EXCEEDS 64K 
GROUP: group name 

Meaning 

Some of the segments of the specified group are not contained within the physical 
segment defined by the group's base. 

Cause 

This error is usually caused by misuse of the ORDER or ADDRESSES control. 

Effect 

LOC86 continues processing the input module. The output module will be 
executable, but addressing errors may result. 

User Action 

Examine the invocation line and reinvoke LOC86 using the ORDER or 
ADDRESSES control more carefully. 



WARNING 19: BOOTSTRAP SPECIFIED FOR MODULE WITHOUT START 
ADDRESS 

Meaning 

You have specified BOOTSTRAP when locating a module that has no start address. 

Effect 

LOC86 continues processing as if no BOOTSTRAP control was specified. 

User Action 

If you wish initialization code in the program, relocate the input module specifying 
both BOOTSTRAP and START. 



ERROR 20: INVALID NAME 
NAME: bad name 

Cause 

This is the result of a typographical error in the NAME control. A valid name is 
composed of up to forty of the following characters in any order: 

• Alphabetic (A, B, C, . . . , Z) 

• Numeric (0, 1,2, ...,9) 

• Special (©,?,:,.,_) 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 
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ERROR 21: SEGMENT REGISTER DEFINED BY SPECIFIED EXTERNAL 
NAME 
NAME: external name 

Meaning 

A segment register or register pair is defined using the specified external symbol 
name. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Relink and relocate your object modules. 



ERROR 22: SEGMENT SIZE OVERFLOW; OLD SIZE + CHANGE > 64K 
SEGMENT: segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment to become 
greater than 64K. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Look at the segment's size in the link map and reinvoke LOC86 with the correct 
SEGSIZE control. 



ERROR 23: SEGMENT SIZE UNDERFLOW; OLD SIZE - CHANGE < 
SEGMENT: segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment's size to be 
less than zero. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Look at the segment's size in the link map and reinvoke LOC86 with the correct 
SEGSIZE control. 
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ERROR 24: INVALID ADDRESS RANGE 

Meaning 

The arguments to the RESERVE control are invalid. 

Cause 

The usual cause of this error is that the low address is larger than the high address. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 



ERROR 25: PUBLIC SYMBOL NOT FOUND 
NAME: public symbol name 

Meaning 

The symbol specified in the START control was not found. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Either specify the argument to START with paragraph and offset, or specify an 
existing public symbol. 



WARNING 26: DECREASING SIZE OF SEGMENT 
SEGMENT: segment name 

Meaning 

The size change specified in SEGSIZE has caused LOC86 to decrease the size of the 
specified segment. 

Effect 

Decreasing the size of a segment can cause sections of code to be unaccounted for 
during the locating process. This is only a warning message. LOC86 continues pro- 
cessing with no side effects. 

User Action 

If the size decrease was not intended, examine the SEGSIZE control in the invoca- 
tion line and relocate. 
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ERROR 27: SPECIFIED SEGMENT IS ABSOLUTE 
SEGMENT: segment name 

Meaning 

You attempted to assign an address to an absolute segment. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 without using absolute segments in the ADDRESSES control. 



WARNING 28: PAGE RESIDENT SEGMENT CROSSES PAGE BOUNDARY 
SEGMENT: segment name 

Cause 

If you have changed the specified segment's size, it may be too large to fit within a 
256 byte page, or if you have specif ed an address for the segment, it may force the 
segment to cross a page boundary. 

Effect 

Since this error can only occur when you have intentionally specified the segment in 
a control, LOC86 ignores the page resident attribute and continues to process the 
module as if no error has occurred. 

User Action 

If you have invoked LOC86 correctly, then the message is only verifying your inten- 
tions — no action is necessary. 
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WARNING 29: OFFSET FIXUP OVERFLOW 
MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

While computing an offset from a base (FRAME OF REFERENCE), LOC86 found 
that the REFERENCED LOCATION was more than 64K bytes away from the base. 

Cause 

This error usually occurs as a result of misuse of the ORDER or ADDRESSES 
control. One of the segments of a group is outside the 64K byte physical segment 
defined by its group base. 

Effect 

LOC86 continues processing. The print file will be valid, but the output file with 
regard to the out-of-place segment will not be usable. 

User Action 

Find the symbol that corresponds to the referenced location, and change the 
ORDER or ADDRESSES control. 



WARNING 30: UNRESOLVED EXTER-NAL REFERENCE TO NAME 
AT SPECIFIED ADDRESS 
NAME: symbol name 
SEGMENT: segment name 
ADDRESS: 20-bit address 

Meaning 

There is no public definition for the specified public symbol. There is an unresolved 
external reference to that symbol in the specified segment. 

Cause 

You are locating a module that is not Completely linked. 

Effect 

LOC86 continues processing with no side effects. The print file will be valid, and 
except for the unresolved references the object file should be executable. 

User Action 

No action is necessary if the unresolved reference is known. Otherwise, you must 
relink and resolve the external reference. 
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WARNING 31: UNRESOLVED EXTERNAL REFERENCE TO NAME NEAR 
SPECIFIED ADDRESS 
NAME: symbol name 
SEGMENT: segment name 
ADDRESS: 20-bit address 

Meaning 

There is no public definition for the specified public symbol. There is an unresolved 
external reference to that symbol in the specified segment. 

Cause 

You are locating a module that has not been completely linked. 

Effect 

LOC86 continues processing with no side effects. The print file will be valid, and 
except for the unresolved references the object file should be executable. 

User Action 

No action is necessary if the unresolved reference is known. Otherwise, you must 
relink to resolve the external reference. 



WARNING 32: OVERFLOW OF LOW BYTE FIXUP VALUE 
MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

An 8-bit displacement value, when calculated, exceeded 255. 

Cause 

This type of error often occurs when a page resident segment crosses a page 
boundary. 

Effect 

LOC86 continues processing. The contents of both the print file and the object file 
will be valid. However, the fixup value will remain invalid. 

User Action 

Find the symbol that corresponds to the REFERENCED LOCATION and organize 
your segments so that the addressing error will not be encountered. 
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WARNING 33: GROUP HAS NO CONSTITUENT SEGMENTS 
GROUP: group name 

Meaning 

The group has no segments and is not placed in the output object file. 

Cause 

Often this is the result of a typographical error in the invocation line. However, it 
may be a linking error that has not shown up until now. 

Effect 

LOC86 continues processing with no side effects. 

User Action 

Unless there is some particular need for the specified group, no user action is 
necessary. 



ERROR 34: SPECIFIED CLASS NOT FOUND IN INPUT MODULE 
CLASS: class name 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Find the module that contains the specified class and link it into the module to be 
located. 



ERROR 35: SPECIFIED SEGMENT NOT FOUND IN INPUT MODULE 
SEGMENT: segment name 
CLASS: class name 



Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Find the module that contains the specified segment and link it into the module to be 
located. 
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WARNING 36: SEGMENTS OVERLAP 
S E G M E N T : segment name 
SEGMENT: segmen t name 
LOW OVERLAP ADDRESS: 20-bit address 
HIGH OVERLAP ADDRESS: 20-bit address 

Meaning 

The two segments overlap in the specified address range. 

Cause 

This can be caused by any number of things: mistake in the SEGSIZE control, 
misuse of ADDRESSES, or two absolute segments that overlap. 

Effect 

LOC86 continues processing the input module. The print file is valid, and the object 
file, with the exception of the overlap, should be usable. 

User Action 

If overlap was intended, no action is necessary. Otherwise, depending on the cause 
of the message, it may be necessary to relocate or even modify the source, and 
retranslate, relink, and relocate. 



ERROR 37: INPUT MODULE EXCEEDS 8086 MEMORY 
SEGMENT: segment name 

Meaning 

While attempting to locate the specified segment, LOC86 ran out of available 8086 
address space. 

Cause 

Although it is possible to write a program that uses a full megabyte of memory, this 
error usually results from an error in the arguments to the RESERVE control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the RESERVE control. If, in fact, your program requires more than 
1,048,576 bytes of memory, try optimizing with ASM86 or use overlays. 
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WARNING 38: SEGMENT WITH MEMORY ATTRIBUTE NOT PLACED 
HIGHEST IN MEMORY 
SEGMENT: segment name 

Meaning 

The specified memory segment was not located at the highest address in memory. 

Cause 

This can only occur when you explicitly request this organization through the 
ORDER or ADDRESSES control, or when you implicitly request it by assigning 
another segment to the top of memory. 

Effect 

Since this can only occur by user request, LOC86 continues processing without side 
effects. 



ERROR 39: NO MEMORY BELOW SEGMENT FOR SPECIFIED SEGMENT 
SEGMENT: segment name 
SEGMENT: segment name 

Meaning 

In the ORDER control you have requested that the first segment be located below 
the second segment. LOC86 found that there is not enough memory to maintain this 
order. 

Cause 

This error can only occur when one of the segments in an ORDER control is 
absolute. The absolute segment is not necessarily either of the segments specified in 
the command. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Modify the order control. 
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WARNING 40: CANNOT MAINTAIN SPECIFIED ORDERING 
SEGMENT: segment name 

Meaning 

LOC86 cannot locate all of the segments in the ORDER control consecutively. 

Cause 

This is usually caused by specifying absolute segments in the ORDER control or by 
specifying the same segments in ORDER and ADDRESSES. The conflict might not 
be immediately obvious. For example, the specified segment may be specified in the 
ORDER control by its segment name and specified in the ADDRESSES control by 
its class name. 

Effect 

LOC86 continues processing. The print and object files are valid. However, the 
requested segment ordering is not maintained. 

User Action 

Carefully examine your invocation line to find the conflict and relocate the input 
module. 



ERROR 41: SPECIFIED CLASS OUT OF ORDER 
CLASS: class name 

Meaning 

The ORDER control and ADDRESSES control for the specified class disagree. 

Cause 

Either you have assigned an address to the specified class or one of its constituent 
segments, or the translator has made one of its constituent segments absolute. In 
either case, the ORDER control cannot be realized. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Modify the ADDRESSES control or modify the ORDER control. 
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ERROR 42: SPECIFIED SEGMENT OUT OF ORDER 
S E G M E N T : segmen t name 

Meaning 

The ORDER control and ADDRESSES control for the specified segment disagree. 

Cause 

Either you have assigned an address to the specified segment or the translator has 
made the segment absolute. In either case, the ORDER control cannot be realized. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Modify the ADDRESSES control or modify the ORDER control. 



ERROR 43: ADDRESS FOR CLASS SPECIFIED MORE THAN ONCE 
CLASS: class name 

Cause 

This is often caused by a typographical error or some other mechanical error while 
entering the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 



ERROR 44: SEGMENT ADDRESS PREVIOUSLY SPECIFIED IN INPUT 
MODULE OR COMMAND LINE 
SEGMENT: segment name 
CLASS: class name 

Cause 

Either the specified segment is absolute or it has been listed twice in the same 
ADDRESSES control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line. If the translator has made it an absolute segment, 
either use the translator-assigned address or retranslate the segment. 
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ERROR 45: SEGMENT SPECIFIED MORE THAN ONCE IN ORDER 
S E G M E NT : segment name 
CLASS: class name 

Cause 

This error can be caused by either of two errors in the invocation line. You have 
simply specified the same segment twice in the ORDER control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and ORDER control and reinvoke LOC86. 



ERROR 46: CLASS SPECIFIED MORE THAN ONCE IN ORDER 
CLASS: class name 

Cause 

You have specified the same class more than once in the same ORDER control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 



ERROR 47: SPECIFIED SEGMENT NOT IN SPECIFIED CLASS 
SEGMENT: segment name 
CLASS: class name 

Cause 

This error is usually caused by a typographical error in the arguments to an ORDER 
control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 
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ERROR 48: INVALID COMMAND LINE 

Meaning 

LOC86 has encountered an end-of-file or an I/O error while reading the invocation 
line. 

Cause 

You probably terminated the invocation line in the middle of a control argument. 
Most likely you forgot to type the ampersand before you typed the carriage return. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 



WARNING 49: SEGMENT ALIGNMENT NOT COMPATIBLE WITH 
ASSIGNED ADDRESS 
SEGMENT: segment name 

Meaning 

The alignment attribute does not agree with the address specified in the 
ADDRESSES control. 

Effect 

LOC86 ignores the address assignment and treats the segment as any other 
relocatable segment. 

User Action 

If the address that LOC86 assigns is satisfactory, then no action is necessary. Other- 
wise, examine the print file and assign an address that will agree with the alignment 
attribute. 
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ERROR 50: INVALID COMMAND LINE; TOKEN TOO LONG 
ERROR IN COMMAND LINE NEAR #: 
partial command tail 

Meaning 

An invocation line "token" is impossibly long. A token is a series of characters that 
are not broken by a parenthesis, a comma or a blank (space, carriage-return, line- 
feed or tab). Tokens are syntactic units used in invocation line parsing. Depending 
on how it is used, a token can be a control word, a symbol name, a segment name, a 
filename, etc. 

Cause 

This is often the result of a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 



WARNING 51: REFERENCING LOCATION IS OUTSIDE 64K FRAME OF 
REFERENCE 
MODULE: module name 
ADDRESS: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

The address of a self-relative reference lies outside of the 64K frame of reference of 
the jump or call. This error occurs while locating the module containing the self- 
relative instruction. 

Cause 

This error occurs as a result of misuse of the ORDER or ADDRESSES control. 

Effect 

LOC86 continues processing. The print file is valid, but the object file with respect 
to the module containing the self-relative reference is not executable. 

User Action 

Examine the locate map and reinvoke LOC86 modifying your ORDER and 
ADDRESSES control to correct the error. 
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WARNING 52: REFERENCED LOCATION OUTSIDE 64K FRAME OF 
REFERENCE 
M D U L E : module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

The target of a self-relative reference lies outside of the 64K frame of reference of 
the jump or call. This error occurs while locating the module containing the target of 
a self -relative instruction. 

Cause 

This error occurs as a result of misuse of the ORDER or ADDRESSES control. 

Effect 

LOC86 continues processing. The print file is valid, but the object file with respect 
to the module containing the self -relative reference is not executable. 

User Action 

Examine the locate map and reinvoke LOC86 modifying your ORDER and 
ADDRESSES control to correct the error. 



WARNING 53: CANNOT ALLOCATE CLASS AT SPECIFIED ADDRESS 
ADDRESS: 20-bit address 
CLASS: class name 

Meaning 

The specified class cannot be located at the address requested. This is the result of a 
conflict with another address assignment, or an absolute segment, or an address less 
than200H. 

Effect 

LOC86 assigns the class to the nearest address that will not cause conflict. LOC86 
continues processing, and both the print and object file are valid. 

User Action 

If the alternate address suits your purpose, then no action is necessary. Otherwise, 
examine the locate map and modify your invocation line. 
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ERROR 54: DATA ADDRESS OUTSIDE SEGMENT BOUNDARIES 
SEGMENT: segment name 
MODULE: module name 

Meaning 

One of the data records associated with the specified segment contains an address 
outside of the segment's boundary. 

Cause 

This error can occur when you assign an address or an order to an absolute segment, 
or a size to a segment. Under some circumstances this can be the result of a linkage 
or translation error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined . 

User Action 

Change the ADDRESSES, ORDER, or SEGSIZE control and relocate. 



WARNING 55: UNDEFINABLE SYMBOL ADDRESS 
SEGMENT: segment name 
MODULE: module name 

Meaning 

A local symbol, line number, or public symbol has been found in the specified seg- 
ment that is addressed relative to the specified group's base address. However, the 
segment containing the symbol is not within the 64K frame of reference that is 
defined for that group. 

Cause 

This is usually the result of an address assignment error in the invocation line. 

Effect 

LOC86 continues processing with no other side effects. The print file and object files 
are valid. However, you cannot use the symbols contained in the specified segment. 

User Action 

Examine the invocation line and reinvoke LOC86. 
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WARNING 56: SEGMENT IN RESERVE SPACE 
SEGMENT: segment name 

Cause 

Either an absolute segment uses the area reserved in the invocation line or you 
assigned an address to a segment or class that forces the specified segment to be 
located in the reserved area. 

Effect 

The specified segment is located in the reserved area, and LOC86 continues process- 
ing with no other side effects. Both the print file and object file are usable. 

User Action 

If the assigned address is acceptable for the segment, no action is necessary. 



ERROR 57: INVALID GROUP NAME 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail. 

Meaning 

LOC86 was expecting a group name when it found a token that did not correspond 
to a valid group name. LOC86 repeats the invocation line up to the point of the 
error. 

Cause 

This is often caused by a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 



ERROR 58: SPECIFIED GROUP NOT FOUND IN INPUT MODULE 
GROUP: group name 

Cause 

This is often caused by a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line to LOC86 and the link map for the input module. 
Reinvoke LOC86 correctly. 
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ERROR 59: GROUP ADDRESS PREVIOUSLY SPECIFIED IN INPUT 
NODULE OR CONNAND LINE 
GROUP: group name 

Cause 

Either you gave a single group an address twice in the same ADDRESSES control or 
the group already had an address (due to a previous locate). 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and either use the previously assigned address or assign 
the group one address per ADDRESSES control. 



WARNING 60: REFERENCED LOCATION IS NOT WITHIN 32K OF 
SPECIFIED ADDRESS 
MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

An 8089 self -relative reference is not within 32K bytes of its target address. 

Cause 

Either with the ORDER or ADDRESSES control you have separated the reference 
from its target or the 8089 segment is too large. 

Effect 

LOC86 leaves the invalid reference and continues processing with no other side 
effects. Both the print file and the object file will be valid. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 



ERROR 61: OVERLAY ERROR 

Meaning 

An internal LOC86 error has occurred. 

User Action 

Contact Intel immediately. 
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WARNING 62: CS AND IP REGISTERS NOT INITIALIZED 

Meaning 

This warning occurs when INITCODE is specified and the input register initializa- 
tion record does not specify intialization of the 8086 code segment (CS) register and 
the 8086 instruction pointer (IP) register. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of CS and IP at the beginning of program execution are completely 
dependent on the loader of your system. 

User Action 

Invoke LOC86 with the START control if desired. 



WARNING 63: SS AND SP REGISTERS NOT INITIALIZED 

Meaning 

The INITCODE control was specified, but the register initialization record does not 
contain information for initialization of stack segment (SS) and stack pointer (SP) 
records. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of SS and SP at the beginning of program execution are entirely depen- 
dent on the loader of your system. 

User Action 

If you will need to use the stack, retranslate your code, then relink and relocate. 
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WARNING 64: DS REGISTER NOT INITIALIZED 

Meaning 

INITCODE was specified, but the data segment (DS) register initialization record is 
incomplete. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The value of the CS register at program execution is entirely dependent on the 
system loader. 

User Action 

Correct your code if necessary, then reinvoke LINK86 and LOC86. 



WARNING 65: SEGMENT ORDER IN ORDER-CONTROL CANNOT BE 
MAINTAINED 
SEGMENT: segment name 

Meaning 

The ADDRESSES and ORDER control specifications for a segment are in conflict 
and/or the segment cannot be allocated space in accordance with the ORDER 
control. 

Effect 

The conflicting segment is allocated space after all other segments in the target 8086 
memory. 

User Action 

If desired, reinvoke LOC86, using the appropriate ADDRESSES and ORDER 
controls. 
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WARNING 66: START ADDRESS NOT SPECIFIED IN OUTPUT MODULE 

Meaning 

The CS (code segment) and IP (instruction pointer) registers are not initialized. 

Cause 

The input module does not have an explicit start address, and the START control 
was not specified. 

Effect 

The values of these registers upon initial program execution are entirely dependent 
on the loader. 

User Action 

Either reinvoke LOC86 using the START control or relink to include a main 
module. 
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OH86 ERROR MESSAGES 



The following are descriptions of all OH86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning — how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect — the state of OH86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the 
resulting code is valid . 

Error and warning messages are displayed at the console device. 



pathname, PREMATURE END-OF-FILE ENCOUNTERED 

Meaning 

OH86 has scanned the entire input file without finding the record that signals the 
end of the module. 

Cause 

There is a transcription error in the specified file. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Return to the last step in the program development process that did not generate this 
error and relocate, relink, or even retranslate. 
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pathname, EXPECTED MODULE HEADER NOT FOUND 

Meaning 

The first record in the input file was not a module header record. 

Cause 

This is usually caused by specifying an input file that does not contain an 8086 object 
module. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Check the invocation line; if you specified the input file incorrectly, then reinvoke 
OH86 more carefully. Otherwise, return to the last step in the program development 
process and reexecute. 

pathname, ILLEGAL RELOCATION RECORD ENCOUNTERED 

Cause 

This error occurs whenever you specify a non-absolute 8086 object module as the 
input file. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Locate the object module with LOC86 before reinvoking OH86. 



pathname, INSUFFICIENT MEMORY TO PROCESS DATA RECORD 

Meaning 

There is insufficient memory in your system for OH86 to process your input file. 

Cause 

You are trying to convert a file that is too complex for the available memory in your 
system. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Expand the memory on your system. 
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pathname, ILLEGAL REGISTER INITIALIZATION RECORD ENCOUNTERED 

Cause 

Your input module contains a register initialization record. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Relocate with INITCODE in effect. 

pathname, ILLEGAL OVERLAY INFORMATION ENCOUNTERED 

Cause 

You attempted to convert a file containing overlay information. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

If overlays are necessary, create root and overlay in separate files. 
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APPENDIX I 

ADDITIONAL INFORMATION 

FOR INTELLEC® SERIES III USERS 



Environmental Considerations 

The iAPX 86,88 Family utilities run on and can be used to produce code executable 
on the Intellec Series III Microcomputer Development System. Resulting code is also 
compatible with the ICE-86 Emulator and DEBUG-86 . 

The following conventions of the Series III operating system (ISIS-II) are 
encountered in running the utilities: 

• The utilities must be executed when the Series III is in the 8086 mode. This 
operating mode is activated by entering the RUN command, either in conjunc- 
tion with a utility program invocation or by itself (to enter the "interactive" 
8086 mode): 



Rj 

; C 


\<z r >B 


|^| 


■ 


^^^| 


HH 


■ 


: L C 8 6 


: F3 


M\ 


•'PRCG . 


lNK<: 


^> 



> 
> 

The :Fn: portion of the pathname is the Series III directory-name. In this 
configuration, the directory-name is the equivalent of a device name, the device 
on which the filename is located. If the file is located on the system disk (:F0:), 
the directory-name may be omitted from the pathname. 

Continuation lines are necessary when a command or invocation will not fit on 
one line. The following example illustrates the line-end conventions to use and 
the continuation characters to expect: 



>>l 

> 



:7 . t z z • 



L I B , U S E R . L I 



[7 . ':c* 



The LIB86 utility presents an exception to these prompt conventions. Because 
this program is interactive, it has its own prompts: 



S ERIES-1 1 1 8086 LIBRARIAN Vx.y 




The following table defines compatible software version combinations. 





ISIS-II 


ISIS-III(D) 
V1.0 or later 


V4.0 


V4.1 


V4.2 


RUN 


— 


V1.0 
V1.1 


V1.0 
V1.1 
V1.2 


V1.3 
or later 


V1.2 


V1.3 
or later 


LINK86 


— 


V1.0 


V1.0 


V2.0 
or later 


V1.0 


V2.0 
or later 


CREF86 


— 


V1.0 or later 


LIB86 


— 


V1 .0 or later 


LOC86 


— 


V1.0 or later 


OH86 


— 


V1.0 or later 
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Related Publications 

The following manuals may be helpful during various aspects of your work with 
iAPX 86,88 utilities on the Series III: 

• Intellec Series III Microcomputer Development System Product Overview, 
order number 121575 

• iAPX 86,88 User's Manual, order number 210201 

• Intellec Series ill Microcomputer Development System Console Operating 
Instructions, order number 121609 

• Intellec Series III Microcomputer Development System Programmer's 
Reference Manual , order number 121618 

• PASCAL-86 User's Guide, order number 121539 

• PL/M-86 User's Guide , order number 1 21636 

• ASM86 Language Reference Manual , ordernumber 121703 

• 8086/8087/8088 Macro Assembler Operating Instructions for 8086-Based 
Development Systems , ordernumber 121674 

• 8089 Macro Assembler User's Guide, order number 9800938 

• FORTRAN-86 User's Guide, order number 121570 

Program Development Examples 

The following examples are programming problems solved by using one or more of 
the iAPX 86,88 utilities on the Series HI to develop code for an 8086-based host. 

Example 1: Preparing to Use DEBUG-86 

There are only two steps to preparing your code for execution: translating the code, 
then linking it with BIND. 

First you must translate your code. Any of the 8086 translators will work. An 
example of one such translation is shown below: 



Once the program has been translated, you must then link the program with the 
BIND control. LINK86 with BIND produces an LTL module — the loader assigns 
addresses to the LTL modules at load time. This operation can be performed by the 
8086 loader, RUN. The operation and control of both of these programs is given in 
the Intellec Series HI Microcomputer Development System Console Operating 
Instructions. 

The invocation line for LINK86 when linking the program shown above might 
appear as follows: 



LINK86 



>>l 



In the above example note that all of the symbol information (LINES, SYMBOLS, 
PUBLICS) is left in the output object file. This will aid you while debugging your 
program. DEBUG-86 uses the symbol information to produce diagnostic informa- 
tion on the program. 

This information is also included in the symbol table. Figure 1-1 shows the print file 
from the invocation above. 
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The libraries specified resolve all of the external references in TEST-OB J . 

After the above linkage, the program can be executed with the following command 
to the Series III: 






SfcfiIES-111 80116 LINKED, Vx.y 

INPUT PILES: :F6:TEST.0BJ, :Fb:UTILS.OBJ , :F6: SMALL. LIB 

OUTPUT FILE: :F6:TEST.8b 

CONTROLS SPECIFIES I* INVOCATION COMMAND: 

BIND 
BATE: Uli/DOIYY TIME: 



LINK MAP OF MODULE ROOT 



LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT 

0351H U CODE 

0014H V CONST 

0196H H DATA 

03F8H U STACK 

OO00H V MEMORY 

OOOOH G ??SEG 

INPUT MODULES INCLUDED: 
:F6: TEST. OS J (ROOT) 
:F6:UT1LS. OBJ (UTILITIES) 
:Fb: SMALL. LIB (DUATTACH) 
: F6 : SMALL .LIB (DQCLOSE ) 
:F6 : SMALL. LIB (DQCREA1E) 



CLASS 

CODE 

CONST 

DATA 

STACK 

MEMORI 



GROUP NAME: COROUF 

OFFSET SEGMENT NAME 
OOOOH CODE 

OROUP NAME: DOROUP 

OFFSET SEGMENT NAME 
OOOOH CONST 
00 MB DATA 
01AAH STACK 
Q5A2B MEMORX 

SYMBOL TABLE OF MODULE HOOT 

BASE OFFSET TXP8 SXMBOL 

0(2) 0164H PUB BINDCONTROL 

0(2) 0O16H PUB BUFBASE 

0(2) 004CH PUB CLASHNODEBASE 

0(2) 0150H FOB C0MMBNTSC0NTROL 

0(2) 017 IB PUB DIBUOTOGGLE 



MODULE NAME ■ ROOT 

BASE OFFSET TYPE SYMBOL 



G(2) 


05A2H 


SIM 


MEMORI 


G(2) 


001 4B 


SIM 


BOFLEN 


0(1) 


00F7B 


SIM 


ERROR 


0(2) 


0018B 


SIM 


LASTNMNODEP 


0(2) 


001 CH 


SIM 


LASTSGNODEP 


0(2) 


0020H 


SIM 


LASTTDNODEP 


0(2) 


0024B 


SIM 


LASTBXNODBP 



BASE OFFSET TIPS SXMBOL 

0(2) 004 AH PUB BHODEBASE 

0(2) 00T4H PUB BUFLEN 

0(2) O05BH PUB COCONN 

0(2) 016FH PUB CURRENTOVERLAXNU 

-M 
0(2) O0A5H PUB DEFAULTPRTFILENA 

-ME 



BASE 


OFFSET 


TIPE 


SIMBOL 


G(2) 


OOOOH 


SIM 


COPIRIGHT 


G(2) 


0016H 


SIM 


BUFBASE 


G(1) 


OOFEH 


SIM 


WARNING 


G(2) 


001AH 


SIM 


FIRSTNMNODEP 


G(2) 


001EH 


SIM 


FIRSTSGNODEP 


G(2) 


O022H 


SIM 


FIRSTTDNODEP 


G(2) 


O026H 


SIM 


FIRSTEJtNODEP 



GO) 


OOAbB 


LIN 


141 








""* 


GOT 






. "— 


00"B"3H 


LIN 


143 


lid) 


OOBEta 


LIN 


144 


GO) 


O0C8H 


LIN 


145 


G(1) 


OOCFB 


LIN 


146 


GO) 


00D2H 


LIN 


148 


G(1) 


OODDh 


LIN 


149 


GO) 


00E7H 


LIN 


150 


G(1) 


OOEEB 


LIN 


152 


GO) 


00F5H 


LIN 


153 


REFERENCES TO 


SEGMENT 


BASES EXIST IN INPUT MODULES: 






ROOT 

















Figure 1-1 . LINK86 Print File for Bound Object Module 
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Although we do not recommend it, it is possible to execute an absolute object 
module with DEBUG-86. However, the module must be located in free user 
memory. DEBUG-86 uses the address from 0FC000H to OFFFFFH, and RUN uses 
the address from 00H to 77FFH. All other memory is available. However, if your 
system does not have a full megabyte of memory, there may be other areas that must 
be reserved. You can use the RESERVE control to prevent LOC86 from using these 
areas. 

The following invocation line is an example of how :F6:TEST.86 might be located; 
although :F6:TEST.86 has been bound, programs that are to be located for execu- 
tion on the Series III need not be bound: 



>>l 



C 8 6 : F6:" 
FFFFH) <cr> 



.86 RESERVE ( 



"7FFH, OFC 



The print file produced from the above invocation is shown in figure 1-2. 



SERIES 


-III 8086 LOCATES, Vx.y ■ 










INPUT 


FILE: :F6:TEST.86 










OUTPUT 


FILE: 


F6:TEST 










CONTROLS SPECIFIED 


IN INVOCATION COMMAND 


: 








RESfiRVE(O0H 


TO 77FFH.OFC000H TO OFFFFFH) 








DATE: 


UM/DD/YY TIME: 










SYMBOL 


TABLE OF MODULE ROOT 










BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


07B8H 


OltCH 


PUB 


BINDCONTROL 


07BUH 


0032H 


PUB 


BNODEBASE 


07B8H 


0031H 


PUB 


CLASHNODEBASE 


07B8H 


0046H 


PUB 


COCONN 


07B8H 


0140H 


PUB 


COMMENTSCONTROL 


07B6H 


0157H 


PUB 


CURRENTOVERLAYNU 
-M 

DEFAULTPRTFILENA 
-ME 

FANODEBASE 


07B8H 


0159H 


PUB 


DEBUGTOGGLE 


07B8H 


008DH 


PUB 


07B8H 


0048H 


PUB 


EXCEPTION 


07B8H 


002EH 


PUB 


07B8H 


0054H 


PUB 


FBLOCKBASE 


07B8H 


0050H 


PUB 


FBLOCKLISTHEAD 


07B8H 


0052H 


PUB 


FBLOCKLISTTAIL 


07B8H 


0123H 


PUB 


FBLOCKSEQUENCENU 
-MBER 



MEMORY 


MAP OF MODULE ROOT 








_ ■ ' 








MODULE 


START ADDRESS PARAGRAPH 


= 081 1H OFFSET 


= 0006H 




SEGMENT 


MAP 












START 


STOP 


LENGTH 


ALIGN 


NAME 


CLASS 


OVERLAY 


07b00H 


07B7CH 


037CH 


M 


CODE 


CODE 




O7B80H 


07B80H 


OOOOh 


M 


CONST 


CONST 




O7B80H 


07D1 IB 


0192H 


M 


DATA 


DATA 




07D12B 


06109H 


03F6H 


M 


STACK 


STACK 




081 OAB 


0810Ah 


OOOOH 


M 


MEMORY 


MEMORY 




081 10U 


06128U 


0019h 


G 


??L0C86_IhlTCO 
-DE 


CODE 




O6130H 


08130H 


OOOOH 


G 


77SEG 






GROUP MAP 












ADDRESS 


GROUP OR 


SEGMENT 


NAME 








O78O0H 


CGROUP 
CODE 












07B80H 


DGROUP 
CONST 
DATA 
STACK 
MEMORY 













Figure 1-2. LOC86 Print File for Bound Object Module 
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Example 2: Preparing to Use an ICE-86 System 

Another way to test and debug software is using in-circuit emulation (ICE) system. 
The ICE-86 loader can load only absolute object modules. Therefore, you cannot 
use the output from LINK86 immediately; it must be located too. 

The whole process of preparing a program for ICE-86 execution takes three steps. 
The first two are the same as in Example 1: the program must be translated and 
linked: 



The above example shows a straightforward linkage with no change to the default 
control setting. Note that NOOVERLAY and NOBIND, the defaults, are set. The 
ICE-86 loader has no facility for dealing with overlay modules created by using the 
LINK86 OVERLAY control. In this case there are no unresolved external references 
in the object module. If the module did contain unresolved references, it could still 
be executed by the ICE-86 system. However, as with execution under DEBUG-86, 
executing instructions that contain unresolved references will produce undefined 
results. 

Figure 1-3 shows the print file produced during the invocation shown above. 
LINK86 does not produce a symbol table with NOBIND is in effect. 

The last step before ICE-86 execution is transforming the relocatable object module 
into an absolute object module with LOC86. The invocation line shown below 
would produce an object file that could be loaded and executed by the ICE-86 
Emulator: 



SERIES«-III 8086 LINKER, Vx.y 

INPUT FILES: :F6:ICETST.0BJ , :F6 :SMALL.LIB 
OUTPUT PILE: :F6:ICETST.LHK 
CONTROLS SPECIFIED IN INVOCATION COMMAND: 
DATB: MM/ODIYY TIME: 



LINK MAP OF MODULE LOANER 

LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT 

037DH V CODE 

0000H V CONST 

0192H H DATA 

0SF8H M STACK 

0O00H H MEMOBI 

0000B G ??SEG 

INPUT MODULES INCLUDED: 

:F6:ICEIST. OBJ (LOANER) 

:F6:SMALL.LIB(DQATTACH) 

:F6: SMALL. LIB(DQCLOSE) 

:F6: SMALL. LIB(DQCREATE) 

: F6 : SMALL . LIB ( DQDBT ACH ) 

:F6 .-SMALL. LIB(DQEXIT) 

: F6 : SMALL . LIB(DQGETSISTEMID) 

: F6 : SMALL. LIB (DQOP EN) 

:F6: SMALL. LIB(DQOVERLAT) 

:F6: SMALL. LIB(DQHRITB) 

: F6 : SMALL .LIB(SISTEMSTACK) 



CLASS 

CODE 

CONST 

DATA 

STACK 

MEMOS! 



Figure 1-3. LINK86 Default Print File 
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This invocation line shows LOC86 invoked with the default control setting. Note 
that the INITCODE control is in effect by default. 

The PL/M-86 program ICETST.SRC is ready for execution on an f CE-86 system. 

Example 3: Using CREF86 

Figure 1-4 illustrates a CREF86 cross-reference listing for an input list of 15 files, 
one of which contains several modules. The output print file pathname OUT and a 
title for the listing were specif ied in the controls. Although PAGE WIDTH (PW) and 
PAGELENGTH (PL) specifications were also noted in the controls, the numbers 
specified are the same as those provided by default. 



CREF86 EXAMPLE OF 


CROSS REFERENCE USING 


CREF86 




MM/DO/YY PAGE 1 


SERIES-III CREF86 v, 


•r 










IHPUT FILES: 


:F1:ROOT.OBJ 


:F1: PARSE. OBJ 


:F1:SIGNON.OBJ 


F1:STATE.OBJ :F1 : ERROR. OB J :F1 :UTILS .OBJ 




:F1:MEHMAN.0BJ 


:Ft:SC ANNS. OBJ 


:F1:PROCES.OBJ 


F1:SCUTIL.OBJ :F1:LIST.0BJ :P1:LSUTIL.0BJ 




:FT:SORT.OBJ 


:F1:UDSMA.LNK 


COMPAC.LIB 




OUTPUT FILE: 


OUT 










CONTROLS SPECIFIED: 


PR(OUT) TT (EXAMPLE OF 


CROSS REFERENCE USING CREF86) PW(120) PL(60) 


MODULES INCLUDED: 












FILE NAME 


MODULE NAHE(S) 










:F1:B0OT.OBJ: 


CREF86 










:F1:PARSE.0BJ: 


PARSE 










:F1:SIGN0N.0BJ: 


SIGNON 










:F1:STATE.OBJ: 


NEXTSTATE 










:F1:ERR0R.0BJ: 


ERROR 










:F1:UTILS.0BJ: 


UTILITIES 










:FV:MBMMAN.OBJ: 


MEMORIMANAGEMBNT 








:F1:SCA»BR.0BJ: 


SCANMODULES 










:F1:PROCES.0BJ: 


PROCESSRECOHDS 










:F1:SCUTIL.0BJ: 


SCANUTILITIES 










:F1:LIST.0BJ: 


LISTOUTPUT 










:F1:LSUTIL.0BJ: 


LISTUTILITIES 










:F1:S0RT.0BJ: 


SIMBOLSORT 










:F1:0DSMA.LHK: 


OBJMAN 










COMPAC.LIB: 


DQALLOCATE 




DQATTACB 


DQCBANGEEXTENSIOH DQCREATE DQDECODEEXCEPTION 




DQDETACB 




DQEXIT 


DQFREE 


DQGBTARGUMEHT DQGETSISTEMID 




DQGETTIME 




DQOPEH 


DQREAD 


DQSEEK DQWRITE ^^.^ 





S1STEMSTACK 








^—-^^^ 


-"""tREF86 EXAMPLE OF 


CROSS -REFERENCE USING 


CREF66 




MM/DD/YY PAGE 2 


S1MB0L NAME 


SiMBOL T1PE 




DEFINING MODULE; 


REFERRING HODOLE(S) 


ACCESS PAGE .... 


. . . UNKNOWN 


NEAR 
NEAR 

WORD 

WORD 
NEAR 


NEAR 
NEAR 


OBJMAN 

OBJMAN 

UTILITIES 

UTILITIES; 

SIMBOLSORT ; 

UTILITIES; 

UTILITIES; 
SIMBOLSORT; 


PARSE SCANMODULES PROCESSRECORDS 

LISTOUTPUT 

PARSE 

LISTUTILITIES 
LISTOUTPUT 


ALLOCATE 


. . . UNKNOWN 








. . . PROCEDURE 


ARRATBASE 


. . . POINTER 


ATOI 


. . . PROCEDURE 


BTOX 


. . . PROCEDURE 


BUBBLESORTVARNAMES. 


. . . PROCEDURE 






NEAR 

NEAR 
NEAR 
BITE 


NEAR 


LISTUTILITIES; 

SCANUTILITIES; 
SCANUTILITIES; 
SCANUTILITIES; 


LISTOUTPUT 

SCANMODULES ^* 
SCANMODULES ^^*^^* 
PROUESSRECCHDS -^•^^^-"^ 


CHECKHEADER . . . . 


. . . PROCEDURE 


CHECKOVERLAI . . . . 


. . . PKOCEDUfit 




. - - PKff'EDUHE 


-^fREF86 EXAMPLE OF 


CROSS REFERENCE USING 


CREF66 




UU/DD/YY PAGE 6 


UNLOAD PAGE .... 




NEAR 
NEAR 
NEAR 
NEAR 
NEAR 
NEAR 




OBJJIAN 

MEMORIMANAGEMENT 
PROCESSRECORDS; 

ERROR; 

LISTUTILITIES; 

LISTUTILITIES; 

LISTUTILITIES; 

LISTUTILITIES; 

PARSE 


; PROCESSRECORDS LISTOUTPUT SIMBOLSORT 
UTILITIES LISTOUTPUT SIMBOLSORT 

SCANMODULES PROCESSRECORDS 

ERROR UTILITIES LISTOUTPUT 

ERROR UTILITIES LISTOUTPUT 

LISTOUTPUT 

UTILITIES LISTOUTPUT 






VBL0CKL1STHEADER 


. . . WORD 










HRITEINITLINEBUF 


. . . PROCEDURE 


hRITELINE 


. . . PROCEDURE 


WRITENEWLINE. . . . 




hRITETOCOMMANDBUF . 


. . . PROCEDURE 


URITETOFILE .... 


. . . PROCEDURE 


NEAR 




LISTUTILITIES; 
UTILITIES 


ERROR LISTOUTPUT 


2ER0 


. . . WORD 







Figure 1-4. CREF86 Cross-Reference Listing 
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Example 4: Building and Using Library Files 



A library is a file that contains object modules. Libraries allow you to collect 
commonly used pieces of software into one file. The library file can be included in a 
LINK86 invocation, and LINK86 will use the modules to resolve references. 



You can add the output from a translator, LINK86, or LOC86 to a library. The 
modules added may be relocatable or absolute; they can have unresolved references 
or be completely linked. 



Let's consider the following scenario — we have created six routines (SINE, 
COSINE, TANGENT, COSECANT, SECANT, and COTANGENT). We want to 
create a library file that will allow each routine to be linked to programs separately. 



The first step necessary to create the library is to translate each routine separately. If 
we were to put them in a single source module, the translator would translate them 
into one module with six public symbols. We could add this module to a library, but 
when we tried to link one of the routines into a program, all six would be included. 



Once the routines are translated, LIB86 can be used to create a library file and add 
modules. The LIST command is used to display the contents of the library and the 
publics contained within it. 




SC . lN K , 

: b<c n >l 



S ERIES- 1 1 1 8086 LIBR ARIAN Vx.y 

* 

* 

":F0:TRIG.LIB 
SIN 

SINE 
COS 

COSINE 

* 

• * 
* 

™F0:TRI6.LIB 
SIN 

SINE 
COS 

COSINE 
SEC 

SECANT 
CSC 

COSECANT 
COT 

COTANGENT 
TAN 

TANGENT 



LNK, &<cr> 
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Example 5: Linking and Locating Programs with 
Overlays Using OVERLAY Control 

The easiest way to build an 8086 program that contain overlays is with LINK86's 
OVERLAY control. Overlay modules built with this control reside in the same file 
as the root. The operating system supplies routines that will load the overlays con- 
structed in this way. See Intellec Series III Microcomputer Development System 
Programmer 's Reference . 

After the program modules that will constitute the root and its overlays are 
translated, each of the overlays and the root must be linked separately. Then the 
root and all of the overlays are linked together. 



The example below shows the first step toward linking overlays- 
modules that will constitute each overlay and the root separately: 



-linking all of the 




K U N L i N 



L A Y L) < : o 



>>l 



Notice that all of the modules, including the root, are linked with the OVERLAY 
and NOBIND controls. The overlay name for the root is not as critical as for the 
overlays, since the overlay name is used when calling the loader. 



Finally, the overlays and root must be linked together. Since any one of the files 
could be the root, LINK86 requires that for the final link the file containing the root 
must be first in the input list. During this final the OVERLAY control is not used: 



>> 



RUN LINK86 R 



V4 . LNK TO 



L N K , V 
. 8 6 < c - >l 



K, 0V3.LNK, &<cr> 



In the invocation, the optional BIND control is specified. The resulting object file is 
executable on a Series III. 



Figure 1-5 shows the LINK86 print file listing for the above invocation. 

There is nothing special about the invocation line to LOC86 when locating a file that 
contains overlays or that has been bound: 



>>l 



The RESERVE control prevents LOC86 from assigning memory addresses reserved 
for the operating system. Figure 1-6 illustrates the printout from this invocation. 
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SBBIES-I1I BOOb LXKKBR, Vx.y 

IUUI FILES: tOOI.LM, 0V1.LMK, 0V2.LKK, C-V3.LBK, 0V«.LftC 

OUTPUT FILE: PROG. 66 

CONTROLS SPECIFIES IB IflTOCATIOM COMMAND? 

BIBS 
DATE: mHOD/YY TIME: 



LIK MP OF MODULE BOOT 



LOGICAL SEGMENTS IBCLODEO: 
LENGTH ADDRESS ALIGN SEGMENT 
3CETH G COOS 

obooh g coast 

2810H B DATA 



CLASS 
CODE 
COHST 
DATA 



OVEBLAI 
BOOT 
BOOT 
ROOT 



INPUT MODULES INCLUDED: 

ROOT. LMK( BOOT) 

OVI.LVX(PAISE) 

0¥2.LMK(ILUDE) 

0»3.LM(PICIL0DE) 

V* . LH ( F ASTLOAD ) 



GROUP SAME : 
OFFSET 
000 OB 
3CEOH 
3CK6H 



CGROUP 
SEGMENT NAME 
C0SB\C0DBYR0OT 
C0DE\C0DE\PASS1 
C0DEVC0DENPASS2 




SYMBOL TABLE OF MODULE BOOT 

BASE OFFSET TXPE SIHBOL 

G(2) 251CH PUB ACTUAL 

G(2) 0F22H PUB BASEFIXUPSEXIST 

G(2) 0D26B PUB BHODEID 

G(2) 0D2BB PUB CLISHNODBID 

G(2) 0F00H PUB COMMEliTSCOliTROL 

6(2) 0F1AB PUB CURRENTOVESLAYNU 




OVERLAY BAME = ROOT, MODULE NAME = ROOT 



BASE 

6(2) 
0(2) 
0(2) 
0(2) 
G(2) 
0(2) 
G(2) 
6(2) 



OFFSET TXPE SYMBOL 



4A20B 
0DO0B 
0D04B 

ODoea 

ODOCH 
0D10H 
0D14H 
0D16B 



SXM 
SIM 
SXM 
SXM 
SXM 
SXM 
SXM 
SXM 



MEMORI 

LASTHMMODEID 

LASTSGMODEID 

LASTIDMODEID 

LASTEXNODEID 

LASTGRHODEID 

LASTOVNODEID 

LASTGBODEID 



BASE 


OFFSET 


TXPE 


SYMBOL 


G(2) 


OFODB 


PUB 


ASSUMEROOTCONTRO 
-L 
B1NDCOHTROL 


6(2) 


orach 


PUB 


G(2) 


24BAB 


PUB 


BUFBASE 


0(2) 


0D5AB 


PUB 


COCONM 


6(2) 


0F50H 


PUB 


CBRRBNTFILNUM 


6(2) 


OFHEH 


PUB 


CURRENTRECINDEX 



BASE 


OFFSET 


TYPE 


SIMBOL 


0(2) 


0002H 


SXM 


COPYRIGHT 


6(2) 


0D02B 


SIM 


FIBSTNMNODEID 


6(2) 


0S06B 


SXM 


PIRSTS6N0DEID 


6(2) 


ODQAB 


SXM 


FIRSTTDNODSID 


0(2) 


ODOEH 


SIM 


FIBSTEXNODEID 


6(2) 


0D12B 


SIM 


FIRSTGRNODEID 


6(2) 


0D16B 


SXM 


FIRSTOVNODEID 


G<2) 


0D1AB 


SXM 


FIRSTBNODEID 



OVERLAY 


BAME = 


ROOT 


, MODULE NAME = L 








-* 1 








— — ' 


IT 








BASE 


OFFSET 


TXPE 


SIMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


6(2) 


4A20H 


SXM 


MEMORI 


6(2) 


003CH 


BAS 


S6N0DE 


6(2) 


0F56B 


SXM 


LITBASE 


6(2) 


0F58H 


SYM 


LITID 


0(2) 


0F56H 


BAS 


LITNODE 


6(2) 


0F5AH 


SYM 


FIRSTMODEIDS 


6(2) 


0F64B 


SXM 


FIRSTNODE 


6(2) 


0F8EH 


SYM 


CURRENTRECINDEX 


6(2) 


0F96B 


SIM 


TEMPLATE 


6(2) 


0FB9B 


SYM 


II 


6(1) 


016EB 


SXM 


6ETLIT 


STACK 


0006H 


SXM 


INDEX 


STACK 


0004B 


SXM 


I 


6(1) 


0207B 


SYM 


SGLIT 



Figure 1-5. LINK86 Listing for Program with Overlays 
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SERIES 


-III bQbb LOCAIbh, Vx.y 










INPUT 


FILE: PROG.b6 










OUTPUT 


FILE: PROG 










CONTROLS SPECIFIED IN INVOCATION COMMAND 










RESEHVE(OH TO 77FFB .0FC0OOB TO 0FFFF*B) 








DATE: 


MM/DD/YY 


TIME: 










SYMBOL 


TABLE OF MODULE ROOT 










BASE 


OFFSET 


TYPE SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


1034H 


251CH 


PUB ACTUAL 


103*H 


OFODB 


PUB 


ASSDMBHOOTCONTRO 
-L 
BIMDCOMTROL 


1034H 


OF22B 


PUB BASEFIXUPSEXIST 


1034H 


OFOCH 


PUB 


1034H 


OD26H 


PUB BNODEID 


1031H 


24EAB 


PUB 


BUFBASE 


1034H 


0D28H 


PUB CLASHNODEID 


103»B 


OD5AH 


PUB 


COCONli 


1034H 


OF00H 


PUB COMMENTSCONTROL 


1034B 


OF50B 


PUB 


CURRENTFILNUM 


1034H 


0F1AH 


PUB CURRENTOVERLAYNU 


1034H 


OF8EH 


PUB 


CURRBBTRECINDEI 






-M 








- 



OVERLAY 


r ROOT 


, MODULE = ROOT 










BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


1034H 


4A20H 


SYM 


MEMORY 


1034H 


0002H 


SYM 


COPYRIGHT 


1034H 


0D00H 


SYM 


LASTNMBODBID 


1034H 


0D02B 


SYM 


PIKSTMWODEID 


1034B 


OD04H 


SYM 


LASTSGNODEID 


1034H 


0D06B 


SYM 


FIRSTSGBODEID 


1034H 


0D08H 


SYM 


LASTTDNODEID 


1034H 


ODOAB 


SYM 


FIRSTTDMODEID 


1034H 


ODOCH 


SYM 


LASTEINODEID 


1034H 


ODOEB 


SYM 


FIRSTEXMODEID 


1034H 


001 OB 


SYM 


LASTGRNODEID 


1034H 


0D12B 


SYM 


FIRSTG BNODEID 


1034H 


0D14H 


SYM 


LASTOVNODEID 


1034B 


0D16H 


SYM 


FIRSTOVBODEID 


1034B 


0D18B 


SYM 


LASTBNODEID 


1034H 


0D1AH 


SYM 


FIRSTBBODEID 


1034H 


0D1CH 


SYM 


SGKODEID 


1034H 


0D1BB 


SYM 


GRHODBID 



OVERLAY = ROOT, MODULE = LIT 



BASE 


OFFSET 


TYPE 


SYMBOL 


BASE 


OFFSET 


TYPE 


SYMBOL 


1034H 


4A20H 


SYM 


MEMORY 


1034H 


003CB 


SYM 


SGNODE 


1034H 


0F56H 


SYM 


LITBASE 


1034H 


0F58B 


SYM 


LITID 


1034H 


0F56H 


SYM 


LITNODE 


1034B 


0F5AB 


SYM 


FIRSTNODEIDS 


1034H 


0F64H 


SYM 


FIRSTBODE 


1034H 


0F8EB 


SYM 


CURRENTHECINDEX 


1034H 


0F96H 


SYM 


TEMPLATE 


1034B 


0FB9H 


SYM 


II 


07»0h 


01bEH 


SYM 


GETLIT 


STACK 


0006U 


SYM 


INDEX 


STACK 


0004H 


SYM 


I 


07bOB 


0207B 


SYM 


SGLIT 



MEMORY MAP OF MODULE ROOT 



MODULE START ADDRESS PARAGRAPH = 14D6H OFFSET 
SEGMENT MAP 



LENGTB ALIGN NAME 



07800H 


0B4E6B 


3CE7H 


M 


CODE 


CODE 


0B4E8H 


0F9BAB 


44D3H 


M 


CODE 


CODE 


0B4E8B 


OEOCEH 


2BE7B 


M 


CODE 


CODE 


0B4E8H 


10337H 


4E50B 


M 


CODE 


CODE 



OVERLAY 

ROOT 
PASS1 
PASS2 
PICPASS2 



GROUP MAP 


ADDRESS 


GROUP OR SEGMENT NAME 


O7800H 


CGROUP 




CODE\CODE\ROOT 




C0DE\C0DE\PASS1 




C0DE\C0DE\PASS2 




C0DE\C0DE\PIC_PASS2 




CODE\CODE\FASTLOAD 


10340H 


DGROUP 




CONSTNCONSTNROOT 




DATA\DATA\ROOT 




STACK\STACK\ 



Figure 1-6 LOC86 Listing for Program with Overlays 
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Example 6: Linking and Locating Programs with Overlays 
Without OVERLAY Control 

It is harder to produce overlay modules without using the OVERLAY control. 
However, sometimes it is necessary to build programs in this way, for example, 
building a program for running under an operating system that does not support 
overlay modules contained in the same file as the root module. 

But regardless of the reason, building overlays in this fashion places an extra burden 
on the programmer. He must do some of the work that would be left to LINK86 
(and LOC86) if he were to use the OVERLAY control. In the following example we 
prepare a root and two overlay modules in separate files. 

First we must compile all modules. Examples of the invocation lines are shown 
below: 



M A L L < c r > 



M P ! M X h 



RC SMALL<cr> 



In the next step we must link the root module to resolve external symbols with a 
library and to obtain a link map: 



RUN LIN 



We will need the link map for locating purposes. The link map, shown in figure 1-7, 
shows the size of each segment in the root. Since the overlays are self-contained 
except for references to the root, we do not need a link map for them. The PL/M-86 
listing files will show the size of each overlay's segments, as illustrated in figure 1-8. 

Note that the length of the root's code segment and OVl's code segment must fit 
within 64K. This means that the code for the overlays must be in a part of memory 
contiguous with the root (to avoid altering the CS register during execution). OV2's 
CONST and DATA segments are larger than OVl's so that the STACK segment 
must be placed to leave room for OV2's CONST and DATA segments. If the 
overlays share the STACK and MEMORY segments with the root, they must be 
located at the same address. 



SERIES-III 8086 LINKER. Vx.y 






INPUT FILES: :F1 :H00T. OBJ, USER . 


LIB 




OUTPUT FILE: :F1:R00T.LNK 






CONTROLS SPECIFIED IN INVOCATION 


COMMAND: 




NAP 






DATE: UIH/DO/YY TIME: 






LINE MAP OF MODULE LOANER 






LOGICAL SEGMENTS INCLUDED: 






LENGTH ADDRESS ALIGN SEGMENT 


CLASS 


OVERLAY 


8A9BH U CODE 


CODE 




038 1H H CONST 


CONST 




029 1R H DATA 


DATA 




0030H M STACK 


STACK 




0000H H MEMORY 


MEMORY 




INPUT MODULES INCLUDED: 






:F1:RO0I.OBJ(R00T) 






:F0:USEH.LIB(LOADER) 






:FO:USER.LIB(EXIT) 






:F0:USER.LIB(ERR0R) 






:F0:USER.LIBlTIME) 




-^ 



Figure 1-7. LINK86 Map for Root File 
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OVl's segment size information 



MODULE INFORMATION: 

CODE AREA SIZE = 7531H 

CONSTANT AREA SIZE = 0081H 

VARIABLE AREA SIZE = 0181H 

MAXIMUM STACK SIZE = 0040H 
918 LINES READ 
PROGRAM ERROR(S) 

END OF PL/M-86 COMPILATION 



30001 D this is the CODE segment 

129D this is the CONST segment 

385D this is the DATA segment 

64D this is the STACK segment 



0V2' s 


segment 


size information 




MODULE INFORMATION 








CODE AREA SIZE = 1B9AH 
CONSTANT AREA SIZE = 0101H 
VARIABLE AREA SIZE = 0454H 
MAXIMUM STACK SIZE = 0067H 
918 LINES READ 
PROGRAM ERROR(S) 


7066D 
257D 

1108D 
103D 


this is the 
this is the 
this is the 
this is the 


CODE segment 
CONST segment 
DATA segment 
STACK segment 


END OF PL/M-86 COMPILATION 









u 









Figure 18. Module Information for Overlays 



After computing the required location for the root's DGROUP and STACK, we can 
locate the root module. The resulting file will not be executable, but it allows us to 
resolve references to the root's code and data symbols in the overlays. The following 
LOC86 invocation will leave room for the overlays' code segments and place the 
DGROUP in the first unused memory location. (In the command line below, the DS 
register is initialized to OFFCEH, and the CS register is initialized to 0.) The STACK 
and MEMORY segments will be located above OV2's DATA segment: 



>: 

>>| 
>>l 



NK S<cr> 



, DGROUP ( 



AC K ( 1 0B34H) )) &<c 



;'! c im : b l l 'J J t , I U l\ b ' , 



"ac < ( GOrt) ; <c -> 



Once the root is located, we can use it to resolve external references in the overlay 
modules. The overlay modules cannot call each other, since only one is resident in 
memory at any time. The link commands are shown below. The NOPUBLICS with 
the EXCEPT control is used to avoid conflicts when we use the located overlays to 
resolve external references in the root: 



>>l 



>>| 

The PUBLICSONLY control resolves references to public symbols contained in the 
root. 
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After the overlays have been linked, they must be located. The code and data 
segments must be placed in the memory locations that were reserved when we first 
located the root. In this case the STACK and MEMORY segments must be the same 
for the overlays and the root: 




>: 
>>| 
>>| 
»l 



OV^ . INK &<: -> 



A, STACK, ME 



* A C < ( 1 C 3 3 4 H ) ) ) & < c r > 



The CGROUP and DGROUP base address must be specified in order to compute 
offset information. The final base address assigned to DGROUP by LOC86 will be 
rounded up to OFFDOH. 

Once the overlays are located, the root is linked and located into an executable form. 
The PUBLICSONLY control will resolve references to symbols in the overlay 
modules. Other than the addition of this input control, the LINK86 and LOC86 
command must be identical to those used previously: 




The executable forms of the root and its overlay files are contained in :Fl:ROOT, 
:Fl:,OVl, and :Fl:OV2. Figure 1-9 shows the resulting layout of memory. 



ROOT CODE 
SPACE 



OVERLAY 
CODE 
SPACE 



ROOT DATA 
SPACE 



OVERLAY 
DATA 
SPACE 



STACK AREA 



MEMORY 



8A9B 
8A9C 



OFFCQ 
OFFCE 



105DF 
105E0 



10B33 
10B34 



10C33 
10C34- 



DS, SS 



Figure 1-9. Memory Organization for Example 6 
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Example 7: Linking 8089 Programs with 8086 Programs 

The process of linking and locating 8086 programs with 8089 programs that use 8089 
local memory is very similar to creating overlay modules in separate files. 

Let us consider the following example: we have created an 8086 program and two 
8089 program modules. The 8089 programs reference each other's symbols and 
public symbols in the 8086 program. In addition, one of the 8089 programs must be 
resident in 8089 local memory. 

The first step is to translate the programs. The 8089 program modules must be 
translated separately, since they will be located in different 8089 address spaces. The 
following lines illustrate the invocation lines to the translators: 




TASK2 should be linked and located first for 8089 local memory. This linkage will 
leave unresolved external references, but it is needed to resolve the references in 
TASK1: 



FFH <c r> 



The RESERVE control in the locate above is a precaution to avoid exceeding 64K. 

The next step is to link and locate the object modules that will reside in the 8086's 
address space. The external references to the 8089 program module that is resident in 
8089 local memory are resolved with the PUBLICSONLY control. The invocation 
lines for linking and locating the modules are: 



>> 



\ L I N K 8 6 : F 1 : P R G 8 6 . B J , & < c r > 

:■ S 6 . _ I B , : F 1 : t a S K1 .OBJ, 8089. LIB, &<:-> 

, D TrmM,^.ri.TA SK2 ) tq : F 1 : 8 6 N 8 9 . L N K < c r >| 



RUN LOG 86 : F 1 : 86N89 . LN K<c o 



:F1:86N89 contains an absolute object module that includes PROG86 and TASK1. 
It may be loaded and executed on an 8086-based system. However, the 8089 pro- 
gram to be located in 8089 local memory still has some unresolved external 
references. To resolve those references we must relink with PUBLICSONLY and 
relocate. The invocation lines to LINK86 and LOC86 shown below are identical to 
those used earlier. This is necessary to guarantee that the references resolved earlier 
are not invalidated: 



NOTE 

The example above makes many assumptions about the 8089 and 8086 code 
that it deals with. In most practical situations it is usually necessary to use a 
more complex LINK86 and LOC86 invocation. However, the example 
above illustrates the key linking and locating principles underlying 
ASM86/ASM89 module combination. 
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Invocation Examples 



The following foldout pages contain examples of the iAPX 86,88 Family utility con- 
trols and commands. The examples, all in the "interactive 8086" mode, may be used 
in conjunction with syntax specifications given: 

• In Chapter 2 for LINK86 

• In Chapter 3 for CREF86 

• In Chapter 4 for LIB86 

• In Chapter 5 for LOC86 

When using the directions in these chapters, fold out the page in this appendix con- 
taining examples of the command or control you are interested in. 

The following is a sample Series III OH86 invocation: 
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Comments 

This example defines two public symbols, VARONE 
and VARTWO, with absolute addresses 50H and 
2000H, respectively. 

In this example the root file is RTFILE and LIB1 and 
LIB2 are library files. 



This line creates an LTL module. The output object 
file is TEST with no extension. 

This example specifies default to avoid ambiguity. 



LINES is the default, so it need not be specified. 



This MEMPOOL example will increase the minimum 
dynamic memory requirements by 20H bytes, and by 
default the maximum size will increase, if necessary, 
to equal the minimum. 

The minimum dynamic memory requirement is 100H. 
The maximum dynamic memory requirement is 
300H. 



Control 



ASSIGN 



ASSUMEROOT 



BIND/NOBIND 
COMMENTS/NOCOMMENTS 

FASTLOAD/NOFASTLOAD 

INITCODE 
LINES/NOLINES 

MAP/NOMAP 
MEMPOOL 



Examples 



JLINK86 FILE1, FILE2, FILE3 ASSIGN &<cr> 
(VARONE (50H) , V A RT WO ( 2 ) )<c r> 



> 
>> 



LINK86 R00T1.0BJ, ROOT 2 . OB J , LIB1, &<cr> 
LIB2 TO RTFI LE OVERLAY<cr> 



> 

>> 

>> 



LINK86 0V11.0BJ, 0V12.0BJ, LIB1, S<cr> 
0V1 .OBJ OVERLAY &<cr> 
ASSUMEROOKRTFI LE) <cr> 



> 

>> 

>> 



LINK86 0V21.0BJ, 0V22.0BJ, L I B 1 , S<cr> 
LIB2 TO 0V2.0BJ OVERLAY &<c r> ] 
AS SUMEROOT (RTFI LE) <cr> 



> 
>> 



LINK86 RTFILE, 0V1.0BJ, 0V2.0BJ &<cr> 
TO PR0G<cr> 



LINK86 TEST. OBJ ,USER. LIB BIND PR I NT<c r> 



LINK86 GEN. OBJ N0BIND<cr> 



LINK86 : F1 :S0URCE.0BJ NOCOMMENTS <cr> 



> 
>> 



LINK86 : F1 : PRO G . OB J TO &<cr> 
: F1 : TEMP . TST COMMENTS <cr> 



> 
>> 



LINK86 PROG. OBJ, LIB1, LIB2 BIND &<cr> 
FAST L0AD<c r> 



LINK86 : F1 : M Y P R G INITC0DE<cr> 



LINK86 : F1 rRUN.OBJ NOLINES<cr> 



LINK86 : F1 : TE ST . OB J LINES<c r> 



LINK86 : F1 : TESTE R . 



MAP<c r> 



> 
>> 



LINK86.86 : F3 : MA I N . OB J , US E R . OB J , &<cr> 
"PUBLICSONLYC: F2:8089. LOC) N0MAP<cr> 



LINK86 : F1 : TES T . OBJ , USER. LIB, &<cr> 
3PASCAL. LIB BIND M EMPO L ( + 2 H )<c r> 



> 
>> 



LINK86 :F1 :TESTED.OBJ MEMPOO L &<cr> 
(100H,+200H) B I N D <c r> 
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SERIES III LIN K86 EXAMPLES 



Comments 

The LINK86 output module will have the name 
specified in parentheses in the control. 



This example removes all debug and public records 
from the object file. 

The EXCEPT in the NOPUBLICS overrides the 
PURGE. 



This use of ORDER specifies the order of segments 
for two groups. 



This example will create an overlay record, and the 
name of the overlay wil be OVERLAY1 . 



Control 



NAME 



OBJECTCONTROLS 



ORDER 



OVERLAY/NOOVERLAY 



Examples 



LINK86 : F1 : TOM. OBJ , SYS. LIB NAME &<cr>_ 
(THIS IS A VERY LONG MODU LE3N AME . Xc r> 



> 
>> 



LINK86 : F1 :SRC1 .OBJ , : F1 :SRC2.0BJ , &<cr> 
:F3:USER. LIB NAME (TEST 5.3)<cr> 



LINK86 : F 1 : F I N A L , USER. LIB, &<cr>| 
3SYS.LIB 0BJECTC0NTR0LS(PURGEXcr> 



LINK86 : F3 :PASCL1 .OBJ &<cr> 

JOB J ECTC 0NT.R0 LS (PURGE, NOPUBLICS &<cr> 

3EX C EPT ( S TART , DATA1, DATA2)Xcr> 



> 

> 

> 

>> 

>> 



LINK86 : F6-.PLMPRG.0BJ , PLM86.LIB, &<cr> 
SMALL. LIB, USER. LIB &<cr> 
0RDER(DGR0UP(SEG1,SEG2\CLASS1, &<cr> 
SEG2ULASS1 \0VERLAY1) , &<cr> 
CGR0UPCCSEG1 , CSEG2, CSEG3) )<cr> 



LINK86 FILE1 , FILE2, FILE3 TO &<cr>_ 
3:F1:0V1.LNK OVER LAY (OVER LAY 1 )<c"r> 



LINK86 FILE4, FILE5, FILE6 TO &<cr>_ 
3:F1 :0V2.LNK 0VERLAY(0VERLAY2Xcr> 



First the constituent files must be linked to form 
overlays. 



The print file is :F1 :TEMP1 .MP1 . 



PRINT/NOPRINT 



LINK86 FILE7, FILES, FILE9 " 

3: F1 : ROOT . LNK OVER LAY ( ROOT Xc r> 



> 
>> 



LINK86 : F1 :R00T. LNK, : F1 :0V1 . LNK, S<cr> 
: F1 :0V2. LNK<cr> 



> 
>> 



LINK86 : F1 : PROG .OBJ TO & <cr> 
: F1 : T EMP 1 .TST PRINT<cr> 



The print file is :F1:PROG.MP1. 
The print file is :F1:THE. MAP. 



This example removes information about line 
numbers, local symbols, and comments from the 
print file. 

This statement removes all but the segment informa- 
tion and error messages from the print file. 



PRINT CONTROLS 



LINK86 : F1 : PROG .OBJ <cr> 



> 
>> 



L I N K 86 : F1 : PROG .OBJ , &<cr> 
USER. LIB P R I NT ( : F1 : THE . MAPXc r> 



LINK86 :F2: TEMP. OBJ &<cr> 

3BIND PRINTC0NTR0LS (NOLINES # &<cr> 

3N0C0MMENTS, NOS YMBO LS Xc r> 



> 
>> 



LINK86 : F3 : P AS C L1 .OBJ &<cr> 
PRINTCONTROLS(PURGE) <cr> 
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Comments 

Public information concerning only DATA1, DATA2, 
LABEL3, and PROC4 is placed in the object file and 
print file. 

All public symbol information will be included in both 
the print file and output file. 

This example will produce a file containing only the 
absolute public symbol records from :F1:8089.LOC. 
The object file will be :F1 -.8089. LNK. 

This will resolve the references in ROOT. OBJ to 
absolute public symbols in the separately linked and 
located overlays OV1 and OV2. 

This produces an object file containing no debug or 
public information. 

This confirms that the line and symbol information 
should be kept in the print file. 

This will change the translator-assigned name 
CGROUP to THE@CODE. A subsequent linkage 
would not combine THE@CODE with a group named 
CGROUP. 

This changes the name .of the CODE group to 
CGROUP. 

This tells the loader that 15FFH bytes of code is the 
minimum requirement for MEMORY. The new max- 
imum size of MEMORY is 35FFH. 

This increments MEMORY'S minimum size by 1FFH 
(7951 D) bytes. The maximum size of MEMORY is 
equal to the old minimum size plus 3FEH (15902D). 

The local symbol records will be included in the 
object file. 

PURGE is a shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, NOTYPE, and 
NOLINES. 

SYMBOLCOLUMNS has no effect, since BIND was 
not specified. 

The symbol table will be printed on a line printer. 



LIBMOD will retain its type information. 



Control 

PUBLICS/NOPUBLICS 



PUBLICSONLY 



PURGE/NOPURGE 



RENAMEGROUPS 



SEGSIZE 



SYMBOLS/NOSYMBOLS 



SYMBOLCOLUMNS 



Examples 



|L I N K 86 : F1 : TEST . OBJ , USER . LIB &<cr> 
jNOPUBLICS EXCEPTC DATA1 , DATA2, &< cr> 
LAB E L3 # PR0C4) <cr> 



> 
>> 



LINK86 : F4 : TEMP . OBJ , SMALL. LIB, &<cr>| 
USER. LIB PUBLICS<cr> 



,L I N K86 PUBLICSONLY ( : F1 : 80 89. L0C)<cr> 



[LINK86 : F1 : ROOT .OBJ , &<cr> 

3PUBLICS0NLYC: F1 :0V1 , : F1 :0V2)<cr> 



LINK86 : F1 : INDEX. OBJ PURGE<cr> 



> 
>> 



LINK86 : F3:FIN AL.QBJ P R I NT CONTR OLS &<cr> 
(N0PURGEXcr> 



> 
>> 



LINK86 :F1 -.PLMPR6.0BJ REN AMEGROUPS &<cr> 
(CGROUP TO THE3C0DE) <c r> 



LINK86 : F9 : ASMPRG . OB J &<cr> 
3RENAMEGR0UPS (CODE TO CGR0UPXcr> 



> 
> 
>> 



LINK86 : F7 : G EORG E . OB J , USER. LIB, &<cr> 
3SYSTEM. LIB BIND S E G S I Z E ( MEMOR Y &<cr>l 
(15FFH, +2000H)Xcr> 



LINK86 : F4 : PRO J CT . OB J , &.<cr> 

3R EST. LIB SEGSIZE (MEMORY ( + 1F'F,+1FF)Xcr> 



> 
>> 



LINK86 : F1 :TEMP. OBJ , USER. LIB &<cr> 
NOSYMBOLS SYMB0LS<cr>l 



TYPE/NOTYPE 



LINK86 : F3 : TEST . OBJ , USER. LIB PURGE<cr> 



LINK86 : F1 : TEST . OBJ SYMBOLCOLUMNS (1 Xc r> 



LINK86 :F1 : ROOT . LNK, : F1 :0V1 . LNK, S<cr> 
3:F1:OV2.LNK,PUBLICSONLY(:F3:8089) &<cr> 
JSYMBOLCOLUMNSU) BIND PR INT ( : LP : Xc r> 



LINK86 : F1 : LIBMOD. OBJ TYPE<cr> 
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Comments 

The cross-reference listing will have 35 lines on each 
page. 

The cross-reference listing will be 100 characters 
wide maximum per page. 

The pathname of the print file will be :F1 :MYFILE. 



Control 



PAGELENGTH 



PAGEWIDTH 



PRINT 



Examples 



CREF86 : F 1 : F I L E 1 , FREAIB &<cr> 
PAGELENGTH (3 5 )<cr> 



> 
>> 



REF86 :F1:PR0G, : F1 : L I B ( MO D1 ) &<cr> 
PAGEWIDTHC100) <cr> 



> 
>> 



CREF86 :F2: FILES (M0DULE1 ,M0DULE2) &<cr> 
PRINK : F1 :MYFILE) <cr> 



The message in the TITLE control must be placed on 
one line. If the message contains special characters, 
it must be enclosed in single quotes ('). 



TITLE 



> 
> 

>> 
>> 



CREF86 MYPROG, HISPROG, HER PROG , &<cr> 
MYLIB, HISLIB, HERLIB TITLE &<cr> 
( 'A CROSS-REFERENCE' ) &<cr> 
PAGEWIDTH(105Xcr>'" 
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Comments 

Three object files are added to the USER. LIB. 



Control 



ADD 



* 

** 



Examples 



ADD : F 1 : S I N , : F 1 : C S , : F 1 : T A N 
: F : U S E R . L I B < c r > 



Three modules from the library LIB. ABC are added 
to:F3:PROJ.TOM. 



This command will produce an empty library file 
called TOMS. LIB. 



Four modules are deleted from the library USER. LIB. 



CREATE 



DELETE 



* 

** 
* 



ADD : F1 : LI B . ABC ( M0D1 , M0D2, M0D3) &< 
TO : F3 : PROJ .T0M<cr> 



CREATE : F3 : TOMS . LI B<c r> 



CREATE : FO : US ER . L I B <c r> 



* 

** 

* 



DELETE : F3 : US ER . LI B (TEMPI , &<cr> 
TEMP?, TEM TMP,TEST?Xcr> 



EXIT 
LIST 



* 
** 

* 
> 



DELETE : FO : I . L I B ( F LOPP Y , CRT, &<cr: 
'PAPER TAPEXcr> 



LIST USER. L I B <« 



USER 
TE 
TE 
EX 
MA 
LO 



. LIB 

MP 

ST 

EC 

IN 

OP 



LIST USER. LIB(TEMF,TESTXcr> 



USER 
TE 
TE 



.LIB 

MP 

ST 



LIST USER. LI B f TEMP . LIB<cr> 



USER 
TE 
TE 
EX 
MA 
LO 

TEMP 
MO 
MO 
MO 



.LIB 

MP 

ST 

EC 

IN 

OP 

.LIB 

DULE1 

DULE3 

DULETC 
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Comments 

If SEG1 is byte alignable, it will be located at 15FFH. 
If SEG2 is byte or word alignable, it will beat4F5AH. 



Address assignment of groups, segments, and 
classes can be in any order, unless they are 
absolute. 



A long jump to GO will be placed at location 
OFFFFOH. 



Control 



Examples 



The initialization code is placed at address 32768 
decimal (8000H). 

No initialization code will be produced. 



LINES is the default, so it need not be specified. 



This statement removes all debug records from the 
object file, but keeps the information in the print file. 



NOPUBLICS is implied by PURGE, but PUBLICS 
overrides it. 

SEG@A of CLASS1 will be the first relocatable 
segment located. SEG@B will be next, followed 
immediately by any other segments contained within 
CLASS1. The extra segments in CLASS1 (and all of 
the segments in CLASS2) are located in the order in 
which they are encountered. Finally, the list in the 
SEGMENTS subcontrol is handled. 



ADDRESSES 



BOOTSTRAP 
COMMENTS/NOCOMMENTS 

INITCODE/NOINITCODE 

LINES/NOLINES 
MAP/NOMAP 

NAME 
OBJECTCONTROLS 



ORDER 



> 

>> 

>> 



0C86 


: F7: 


COME. 


LNK 


TO 


:F8: 


WENT 


I < c 


ADDRE 


: S S E S ( S E Gh 


iiaiwaa 


G 1 \ C 


IMaaa 


■■KJ 


V E R L A Y 3 ( 


1 5 F F h 


<>, 


S EG 2 


( k F 5 A H ) X 


C r >i 



> 
> 

>> 
>> 



L C 8 6 : F 8 : I S T . L N K TO L C I S T . R D Y & < c r ■> 
A D D R E S S E S ( S E G M E N T S ( S E G 1 \ C L A S S 1 $<cr > 
(23H)), GROUPSCCGROUP(OOH) , DGROlP i* 
(1 0OOH) ) , C LASSES (MEMORY ( 1 5000 H; , ; < 



> 
>> 



L0C86 :F3:TEST.LNK START(GO) &<c^>' 
B00TSTRAP<cr>| 



L0C86 : F1 :S0URCE. LNK NOCOMMENTS <c r> 



: F1 :TEMP. LNK COMMENTS<cr> 



0C86 : F 1 : FORK . LNK I N I TCODE (3 2768)<c<> 



L0C86 : F 1 : TEST . LN K NO I N I T COD E <c r> 



L0C86 : F1 : RUN . LNK NOLINES<cr> 



L0C86 : F1 : T EST . LNK<cr> 



L0C86 : F1 : T ESTER . LNK MAP<cr> 



> 
>> 



L0C86 : F 3 : G ON E . LNK TO &<c r> 

i: F2: HERMAF . OVY N0MAP<cr> 



>| 
>>l 



DC86 : F4:SH0RT. LNK NAME &<cr> 

(THIS IS A VERY LONG : MODU LE3N AME . )<c r> 



L0C86 : F1 : UPWAR D . LNK &<cr> 
jOBjECTCONTROLS (NOLINES, &<cr> 
SnOCOMMENTS. N0SYMB0LSXcr> 



> 
>> 



L0C86 :F3:PASCL1.LNK &<c-> 
OBJECTCONTROLS (PURGE , PUB LI CS) <c r> 



L0C86 : F0 : S PC S E Q . LNK ORDER £<cr> 
(CLASSES (CLASS1 CSEG3A, SEGSB) , 8<c> 
CLASS2) f SEGMENTS CSEG1 \CLASS3 & < : - > 

\ V E R L A Y 1 , S E G 2 2 , S E G 1 \ C L A S S 5 ) X c r > 
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Comments 

The print file is :F1:TEMP.MP2. 

The print file is :F5:INTERPL.MP2. 

The print file is :F1 :MAP. 

Information about line numbers is removed from the 
print file. 

All but the segment information is removed from the 
print file. 

No public information is included in the output files 
(:F7:PRIVAT.MP2and :F7:PRIVAT). 

All public symbol information will be included in both 
the print file and output file. 

The object file contains no public or debug informa- 
tion, and the symbol table does not appear in the 
print file. 

The line and symbol information will be kept in the 
print file and object file. 

This control reserves the high order 64K of memory. 



Control 



PRINT/NOPRINT 



PRINTCONTROLS 



PUBLICS/NOPUBLICS 



PURGE/NOPURGE 



RESERVE 



Examples 



> 
>> 



L0C86 : F1 : P R G . LNK TO &<cr> 
:F1 : TEMPI . TST PRINT<cr> 



L0C86 : F5: INTERP. LNK<cr> 



L0C86 :F4:PR0G.LNK PR I N T -( : F1 : MAPXc r> 



L0C86 : F1 : LINEAR. LNK &<cr> 
3PRINTC0NTR0LS (NOLINESXcr> 



> 
>> 



L0C86 :F3:PR0G.LNK PRINTCONTROLS &<cr> 
(PURGEXcr> 



L0C86 : F 7 : P R I V A T . LNK NOPUB L I CS<c r> 



> 
>> 



L0C86 : F9 : TEXT . LN K NOPUB LI C S &<cr> 
PU B LI CS <c r> 



L0C86 : F3-.PR0J5 .LNK PURGE<cr> 



> 
>> 



L0C86 : F 5 : B0209 . LNK PURGE &<cr> 
PRINTCONTROLS (NOPURGEXcr> 



> 
>> 



L0C86 : F3 : LOWMEM . LNK RESERVE &<cr> 
(OFOOOOH TO OFFFFFH) <cr> 



A 200H and a 100H section of memory at the top and 
bottom of memory are reserved. 

The size of segment MEMORY will be increased by 
2000 bytes. 

The size of segment FREUD will be decreased by 
511 bytes. 

The new segment size forXENDA is 7770 bytes. 



SEGSIZE 



> 
>> 



0C86 : F 2 : HUGOS . LNK RESERVE &<cr> 

(00H TO 0200 H , OFFF00H TO OF FF F FH) <c r> 



> 
>> 



L0C86 : F6 : GROW . LN K SE^SI^ZE S<cr> 
" (MEMORY (+20 00) )<cr> 



> 
>> 

> 
>> 



0C86 :F1: S HR I N K . LN K_SjEGS I ZE _&<c r> 
( FREUD (-1 FFH)) <cr> " 



0C86 : F1 : RP LAC E . LNK SEGSIZE &<cr> 
(XENDA(7770)Xcr> 



:F9:AUTO will start at IGNITION. 

:F7:HALTS will start at location 200H. 

This statement will include the local symbol records 
in the object file and the symbol information in the 
print file. 

PURGE is a shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, and NOLINES. 



The symbol table will be printed on a line printer. A 
line printer line can hold a four-column symbol table. 



START 



SYMBOLS/NOSYMBOLS 



SYMBOLCOLUMNS 



L0C86 : F9 : AUTO . LN K START ( I GN IT IONXc r> 



L0C86 :F7: HALTS . LNK START (00H , 200HXc r> 



L0C86 GESHTA. LNK S YMBO LS <c r> 



L0C86 : F 3 : T E S T . LNK PURGE<cr> 



L0C86 :F1:TEST.LNK S YMBO LC0 LUMNS ( 1 ) < : - > 



L0C86 : F5: LINKED. LNK &<cr> 
3SYMB0LC0LUMNS (4) PRINT(:LP:Xcr>| 
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absolute object file formats, A-l 
absolute object modules, 1-2 
AD, 5-3 
address, 

in ADDRESSES control, 5-3 

in ASSIGN control, 2-4 

in INITCODE control, 5-6 

in RESERVE control, 5-16 
ADDRESSES, 5-3 
addressing, 

A, 4-2 

absolute, 1-4, 2-4 

ADD, 4-2 

8086, 1-5 

relative, 1-4 
alignment, 

boundaries, 1-8 

of segments, 1-7 
AR, 2-5 
AS, 2-4 
ASSIGN, 2-4 
available memory, effect of, C-l 

BI, 2-6 

BIND, 2-6 

BOOTSTRAP, 5-4 

bound modules (see LTL modules) 

BS, 5-4 

C,4-3 

class, 8086, 1-9 
CLASSES, 5-3, 5-11 
class name, 
in ADDRESSES control, 5-3 
in ORDER control, 
LINK86, 2-15 
LOC86,5-ll 
in SEGSIZE control, 
LINK86, 2-23 
LOC86, 5-17 
CM, 2-7 
COMMENTS, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
iriPRINTCONTROLS, 
LINK86, 2-18 
LOC86,5-13 
LINK86 control, 2-7 
LOC86 control, 5-5 
control summary, 
CREF86, E-l 
LIB86, F-l 
LINK86, D-l 
LOC86, G-l 
CREATE, 4-3 
CREF86, 
controls, 
PAGELENGTH, 3-3 
PAGEWIDTH, 3-4 



PRINT, 3-5 
TITLE, 3-6 

control summary, 3-2 

error messages, E-l 

in development process, 1-1 

input, 3-1 

invocation, 3-2 

output, 3-1 

print file, 3-7 

Series III invocation examples, I-23/I-24 

use of libraries, 1-3 
cross-reference listing, 3-7 
CS, 5-3, 5-11 

D,4-3 

data records, 8086, A-3 

debug records, 

LINK86, 2-21 

LOC86, 5-15 
DELETE, 4-3 

E,4^ 

ENDREC, A-7 
error messages, 
CREF86, E-l 
LIB86, F-l 
LINK86, D-2 
LOC86, G-2 
OH86, HI 
examples, Series III, 
invocation, 
CREF86, 1-23/I-24 
LIB86, 1-25/I-26 
LINK86, 1-17/I-18 
LOC86, 1-27/I-28 
OH86,I-15 
program development, 
CREF86, 1-6 
LIB86, 1-7 

LINK86, 1-2, 1-5, 1-8, 1-11, 1-14 
LOC86, 1-4, 1-5, 1-8, 1-12 
EXIT, 4-4 
external references, 
cross-reference listing, 3-7 
definition of, 1-2 
resolution of , 1-3 

FASTLOAD,2-8 
FL, 2-8 

GR, 5-3 

group, 
addressing, 1-9 
8086, 1-9 

group map, 2-27 

group name, 
in ADDRESSES control, 5-3 
in LINK86 ORDER control, 2-15 
in LINK86 RENAMEGROUP control, 2-22 

GROUPS, 5-3 
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hexadecimal-decimal conversion, B-l 
hexadecimal object file format, 
conversion to, 6-1 
records of, 
data, A- 13 
end of file, A- 15 
extended address, A- 12 
start address, A- 14 

IC, 

LINK86, 2-9 

LOC86, 5-6 
INITCODE, 

LINK86, 2-9 

LOC86, 5-6 
initialization code, 

LINK86, 2-9 

LOC86, 5-6 
input list control, 2-20 

L.4-6 

LHEADR, A-6 
LI, 
LINK86, 2-10 
LOC86, 5-7 
LIB86, 
commands, 
ADD, 4-2 
CREATE, 4-3 
DELETE, 4-4 
EXIT, 4-5 
LIST, 4-6 
command summary, 4-1, F-l 
error messages, F-l 
in development process, 1-1 
input, 4-1 
invocation, 4-1 

Series III invocation examples, I-25/I-26 
librarian (see LIB86) 
libraries, 
adding to, 4-2 
creating, 4-3 
deleting from, 4-4 
listing contents of, 4-6 
use of by CREF86, 1-3 
useofbyLINK86, 1-3 
line number control, 
LINK86, 2-10 
LOC86, 5-7 
LINES, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-10 
LOC86, 5-7 
link map, 2-27 
linkage (see LINK86) 
LINK86, 
and LOC86, 1-4 
controls, 
ASSIGN, 2-4 
ASSUMEROOT, 2-5 



BIND, 2-6 

COMMENTS, 2-7 

FASTLOAD, 2-8 

INITCODE, 2-9 

LINES, 2-10 

MAP, 2-1 1 

MEMPOOL, 2-12 

NAME, 2-13 

NOBIND, 2-6 

NOCOMMENTS, 2-7 

NOFASTLOAD, 2-8 

NOLINES, 2-10 

NOMAP, 2-11 

NOOVERLAY, 2-16 

NOPRINT, 2-17 

NOPUBLICS, 2-19 

NOPURGE, 2-21 

NOSYMBOLS, 2-24 

NOTYPE, 2-26 

OBJECTCONTROLS, 2-14 

ORDER, 2-15 

OVERLAY, 2-16 

PRINT, 2-17 

PRINTCONTROLS, 5-12 

PUBLICS, 2-19 

PUBLICSONLY, 2-20 

PURGE, 2-21 

RENAMEGROUPS, 2-22 

SEGSIZE, 2-23 

SYMBOLCOLUMNS, 2-25 

SYMBOLS, 2-24 

TYPE, 2-26 
control summary, 2-2, D-l 
error messages, D-2 
in development process, 1-1 
input, 1-4,2-1,2-20 
invocation, 2-1 
output, 1-4, 2-1 
print file, 2-27 
segment combination, 1-7 
Series III invocation examples, I-17/I-18 
use of libraries, 1-3 
LIST, 4-6 

load-time-locatable module (seeLTL module) 
location (seeLOC86) 
location algorithm, 
for modules with overlays, 5-25 
for segments, 5-24 
LOC86, 
and LINK86, 1-4 
controls, 

ADDRESSES, 5-3 

BOOTSTRAP, 5-4 

COMMENTS, 5-5 

INITCODE, 5-6 

LINES, 5-7 

MAP, 5-8 

NAME, 5-9 

NOCOMMENTS, 5-5 

NOINITCODE, 5-6 

NOLINES, 5-7 

NOMAP, 5-8 

NOPRINT, 5-12 

NOPUBLICS, 5-14 

NOPURGE, 5-15 
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NOSYMBOLS, 5-19 

OBJECTCONTROLS, 5-10 

ORDER, 5-11 

PRINT, 5-12 

PRINTCONTROLS, 5-13 

PUBLICS, 5-14 

PURGE, 5-15 

RESERVE, 5-16 

SEGSIZE, 5-17 

START, 5-18 

SYMBOLS, 5-19 

SYMBOLCOLUMNS, 5-19 
control summary, 5-2, G-l 
error messages, G-2 
in development process, 1-1 
input, 1-4, 5-1 
invocation, 2-1 
output, 1-4, 5-1 
print file, 5-21 

Series III invocation examples, I-27/I-28 
LTL controls, 
BIND, 2-6 
FASTLOAD, 2-8 
MEMPOOL, 2-12 
ORDER, 2-15 
PRINTCONTROLS, 2-18 
SEGSIZE, 2-23 
SYMBOLCOLUMNS, 2-25 
LTL modules, 1-2, 1-4, 1-10 

MA, 

LINK86, 2-1 1 

LOC86, 5-8 
MAP, 

LINK86, 2-11 

LOC86, 5-8 
maximum-size, 

in MEMPOOL control, 2-12 

in SEGSIZE control, 2-23 
memory, 

configuration with overlays, 1-10 

8086, 1-5 
memory map, 5-23 
memory requirements controls, 

LINK86 MEMPOOL, 2-12 

SEGSIZE, 
LINK86, 2-23 
LOC86, 5-17 
MEMPOOL, 2-12 
minimum-size, 

in MEMPOOL control, 2-12 

in SEGSIZE control, 2-23 
MODEND, A-9 
module attributes, A-2 
module identification, A-2 
module name, 

in LINK86 NAME control, 2-13 

in LOC86 NAME control, 5-9 
MP, 2-12 

NA, 

LINK86,2-13 

LOC86, 5-9 
NAME 

LINK86, 2-13L 



LOC86, 5-9 
naming output module, 
LINK86.2-13 
LOC86, 5-9 
NOBI, 2-6 
NOBIND, 2-6 
NOCM, 2-7 
NOCOMMENTS, 

in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86,2-18 
LOC86, 5-13 
LINK86, 2-7 
LOC86, 5-5 
NOFASTLOAD, 2-8 
NOFL, 2-8 
NOIC, 5-6 
NOINITCODE, 5-6 
NOLI, 

LINK86, 2-10 
LOC86, 5-7 
NOLINES, 

in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86,2-18 
LOC86, 5-13 
LINK86, 2-10 
LOC86, 5-7 
NOMA, 
LINK86,2-11 
LOC86, 5-8 
NOMAP 
LINK86,2-11 
LOC86, 5-8 
NOOV, 2-16 
NOOVERLAY, 2-16 
NOPL, 

LINK86, 2-19 
LOC86, 5-14 
NOPR, 
LINK86, 2-17 
LOC86,5-12 
NOPRINT, 
LINK86, 2-17 
LOC86.5-12 
NOPU, 

LINK86, 2-21 
LOC86,5-15 
NOPUBLICS, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-19 
LOC86, 5-14 
NOPURGE, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
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inPRINTCONTROLS, 

LINK86.2-18 

LOC86, 5-13 
LINK86, 2-21 
LOC86, 5-15 
NOSB, 
LINK86, 2-24 
LOC86, 5-19 
NOSYMBOLS, 
in OBJECTCONTROLS, 

LINK86, 2-14 

LOC86, 5-10 
inPRINTCONTROLS, 

LINK86, 2-18 

LOC86, 5-13 
LINK86, 2-24 
LOC86, 5-19 
NOTY, 2-26 
NOTYPE, 
in OBJECTCONTROLS, 2-14 
in PRINTCONTROLS, 2-18 
LINK86, 2-26 

OBJECTCONTROLS, 

LINK86, 2-14 

LOC86, 5-10 
object module format, 1-4, A- 1 
OC, 

LINK86, 2-14 

LOC86, 5-10 
OD, 

LINK86,2-15 

LOC86,5-ll 
offset, 5-18 
OH86, 

error messages, H-l 

in development process, 1-1 

input, 6-1 

invocation, 6-1 

output, 6-1 

Series HI invocation example, 1-15 
ORDER, 

LINK86,2-15 

LOC86, 5-11 
OV, 2-16 
OVERLAY, 2-16 
overlay controls, 

ASSUMEROOT, 2-5 

OVERLAY, 2-16 
overlay, 8086, 1-10 
overlay name, 

ADDRESSES, 5-3 

LINK86 ORDER control, 2-15 

LINK86 OVERLAY control, 2-16 

SEGSIZE, 
LINK86,2-23 
LOC86, 5-17 
overlays and location, 5-25 
OVLDEF, A-7 

PAGELENGTH, 3-3 
PAGEWIDTH, 3-4 
paragraph, 5-18 
pathname, 
in ASSUMEROOT control, 2-5 



in LIB86 commands, 4-1 
in PRINT control, 
LINK86, 2-17 
LOC86, 5-12 
in PUBLICSONLY control, 2-20 
PC, 
LINK86, 2-18 
LOC86, 5-13 
PEDATA, A-10 

performance-memory relationship, C-l 
PIC, 1-10 
PIDATA, A-10 
PL, 
CREF86, 3-3 
LINK86, 2-19 
LOC86, 5-14 
PO, 2-20 

position-independent code (see PIC) 
PR, 
CREF86, 3-5 
LINK86, 2-17 
LOC86, 5-12 
PRINT, 

CREF86, 3-5 
LINK86, 2-17 
LOC86.5-12 
PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
print file, 
controls, 
CREF86, 3-2 
LINK86.2-18 
LOC86, 5-13 
CREF86, 
cross-reference information, 3-8 
header, 3-7 
module list, 3-8 
warnings, 3-7 
LINK86, 
error messages, 2-30 
group map, 2-28 
header, 2-27 
link map, 2-11,2-27 
symbol table, 2-29 
LOC86, 
errors and warnings, 5-24 
memory map, 5-23 
symbol table, 5-21 
print file name, 
LINK86,2-17 
LOC86, 5-12 
program development, 1-1 
PU, 

LINK86, 2-21 
LOC86, 5-15 
PUBLICS, 
in LIB86 LIST control, 4-6 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86.2-19 
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LOC86, 5-14 
PUBLICSONLY, 2-20 
public symbol, 1-2, 5-18 
public symbol cross-references, 3-7 
public symbol records, 
in libraries, 4-6 
LINK86, 

PUBLICS/NOPUBL1CS, 2-19 
PUBLICSONLY, 2-20 
LOC86, 5-14 
PURGE, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-21 
LOC86, 5-15 
PW, 3-4 

record formats, 

end, A-7 

L-module header, A-6 

module end, A-9 

overlay definition, A-7 

physical enumerated data, A- 10 

physical iterated data, A- 10 

register initialization, A-8 

R-module header, A-6 

sample, A-4 

T-module header, A-5 
record syntax, A-3 
REGINT, A-8 

register initialization, 2-9, 5-6, A-8 
relocatable object module, 1-2 
relocation (see LOC86) 
RENAMEGROUPS, 2-22 
RESERVE, 5-16 
RG, 2-22 
RHEADR, A-6 
RS, 5-16 

SAMREC, A-4 
SB 

LINK86, 2-24 

LOC86, 5-19 
SC 

LINK86, 2-25 

LOC86, 5-20 
segment, 

alignment, 1-7, 2-28 

combining, 1-8 

8086, 1-6, A-2 

locating, 1-8, 5-24 

memory, 1-8, 2-23, 5-17 

ordering, 
LINK86, 2-15 
LOC86, 5-11, 5-24 

stack, 1-8 



segment addressability, A-2 
segment location algorithm, 

absolute segments, 5-24 

relocatable segments, 5-25 

segment ordering, 5-24 
segment map, 2-29 
segment name, 

in ADDRESS control, 5-3 

in ORDER control, 
LINK86, 2-15 
LOC86,5-ll 

in SEGSIZE control, 
LINK86, 2-23 
LOC86, 5-17 
SEGMENTS, 5-3 
SEGSIZE, 

LINK86, 2-23 

LOC86, 5-17 
Series III information, 

continuation-line characters, 1-1 

environmental considerations, 1-1 

ISIS-II conventions, 1-1 

program development examples, 1-2 

prompts, 1-1 

related publications, 1-2 

software version compatibilities, 1-1 
size, 5-17 
SM, 5-3, 5-11 
SS, 

LINK86, 2-23 

LOC86, 5-17 
ST, 5-18 
START, 5-18 
start address, 5-4, 5-18 
SYMBOLCOLUMNS, 

LINK86, 2-25 

LOC86, 5-20 
SYMBOLS, 

in OBJECTCONTROLS, 
LINK6, 2-14 
LOC86, 5-10 

in PRINTCONTROLS, 
LINK86.2-18 
LOC86, 5-13 

LINK86, 2-24 

LOC86, 5-19 
symbol table, 

LINK86, 2-25, 2-29 

LOC86, 5-20, 5-21 

THEADR, A-5 

TITLE, 3-6 

TT, 3-6 

TY, 2-26 

TYPE, 
in OBJECTCONTROLS, 2-14 
in PRINTCONTROLS, 2-18 
LINK86 control, 2-26 

type checking, 2-26 

variable name, 2-4 
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